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

El método InitializeDecode inicializa el objeto de una matriz de bytes que contiene el valor de propiedad. La matriz de bytes se representa mediante una cadena con codificación Unicode.

Syntax

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Parámetros

[in] Encoding

Valor de enumeración EncodingType que especifica el tipo de codificación Unicode aplicada a la cadena de entrada.

[in] strEncodedData

Variable BSTR que contiene el valor de propiedad codificada Reglas de codificación distinguidas (DER).

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.

Observaciones

Especifique la propiedad que se va a inicializar llamando a la propiedad PropertyId . Puede llamar a la propiedad RawData para recuperar el valor de la propiedad codificada. Llame al método SetValueOnCertificate para asociar el valor de propiedad a un certificado.

Si se produce un error en el método InitializeDecode , el objeto ICertProperty no se inicializa y el valor de la propiedad de entrada no se guarda. Sin embargo, la propiedad PropertyId conserva el identificador especificado.

El método InitializeDecode se proporciona para permitirle inicializar propiedades y propiedades personalizadas identificadas en la enumeración CERTENROLL_PROPERTYID para la que no existe ninguna interfaz específica. Cada uno de los valores admitidos en esa enumeración contiene información sobre el tipo de datos, normalmente un CRYPT_INTEGER_BLOB, que debe proporcionar al método InitializeDecode . Puede usar la interfaz IBinaryConverter para convertir una matriz de bytes en una cadena.

Las interfaces siguientes simplifican la creación de las propiedades más comunes:

• ICertPropertyArchived
• ICertPropertyArchivedKeyHash
• ICertPropertyAutoEnroll
• ICertPropertyBackedUp
• ICertPropertyDescription
• ICertPropertyEnrollment
• ICertPropertyFriendlyName
• ICertPropertyKeyProvInfo
• ICertPropertyRenewal
• ICertPropertyRequestOriginator
• ICertPropertySHA1Hash

Requisitos

Consulte también

ICertProperties

ICertProperty