Compartir a través de

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

  • Artículo

El método InitializeDecode inicializa el objeto a partir de una matriz de bytes codificada reglas de codificación distinguida (DER) que contiene el certificado que se va a renovar. 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 certificado codificado en DER.

A partir de Windows 7 y Windows Server 2008 R2, puede especificar una impresión digital de certificado o un número de serie en lugar de un certificado codificado. Si lo hace, la función buscará en los almacenes locales adecuados 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.
  • Si se necesita una clave privada, solo se buscan los almacenes personales y de solicitud.
  • Si no se necesita una clave privada, también se buscan los almacenes de CA raíz e intermedia.

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. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

El identificador de objeto (OID) de este atributo es XCN_OID_RENEWAL_CERTIFICATE (1.3.6.1.4.1.311.13.1). Para obtener más información, consulte CERTENROLL_OBJECTID.

Puede usar este método si tiene un objeto notación de sintaxis abstracta con codificación DER (ASN.1) que contiene el valor del atributo. Debe proporcionar el objeto codificado en DER en una cadena codificada unicode. Para obtener más información, consulte la interfaz IBinaryConverter .

Debe llamar a InitializeEncode o InitializeDecode para poder usar un objeto IX509AttributeRenewalCertificate . Los dos métodos se complementan entre sí. El método InitializeEncode permite construir una estructura ASN.1 codificada a partir de datos sin procesar y el método InitializeDecode permite inicializar datos sin procesar a partir de una estructura ASN.1 codificada. Puede llamar a la propiedad RenewalCertificate para recuperar los datos sin procesar.

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

IX509AttributeRenewalCertificate