Método ICertProperty::RemoveFromCertificate (certenroll.h)

El método RemoveFromCertificate desasocia una propiedad de un certificado. Especifique la propiedad que se va a quitar llamando a la propiedad PropertyId .

Syntax

HRESULT RemoveFromCertificate(
  [in] VARIANT_BOOL MachineContext,
  [in] EncodingType Encoding,
  [in] BSTR         strCertificate
);

Parámetros

[in] MachineContext

Valor de VARIANT_BOOL que indica si el almacén de certificados se encuentra en el equipo local. Especifique VARIANT_TRUE si el almacén es local.

[in] Encoding

Valor de enumeración EncodingType que especifica el tipo de codificación aplicada a la cadena de certificado identificada por el parámetro strCertificate .

[in] strCertificate

Variable BSTR que contiene el certificado codificado en DER.

A partir de Windows 7 y Windows Server 2008 R2, puede especificar una impresión digital del certificado o un número de serie en lugar de un certificado codificado. Si lo hace, la función busca los almacenes locales adecuados para el certificado coincidente. Tenga en cuenta los siguientes puntos:

• El BSTR debe ser un número par de dígitos hexadecimales.
• Se omite el espacio en blanco entre pares hexadecimales.
• El parámetro Encoding debe establecerse en XCN_CRYPT_STRING_HEXRAW.
• El parámetro MachineContext determina si se buscan el usuario o el equipo o ambos.
• Si se necesita una clave privada, solo se buscan los almacenes personales y de solicitudes.
• Si no se necesita una clave privada, también se buscan los almacenes de CA raíz e intermedio.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Requisitos

Consulte también

ICertProperties

ICertProperty