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.

Sintaxis

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 codificado reglas de codificación distinguida (DER).

Valor devuelto

Si la función se realiza 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 los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código o valor devuelto	Descripción
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	El objeto ya se ha inicializado.

Comentarios

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

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certenroll.h
Archivo DLL	CertEnroll.dll

Consulte también

ICertProperties

ICertProperty