IX509AttributeRenewalCertificate::InitializeEncode (certenroll.h)

  • Artículo

El método InitializeEncode inicializa el atributo mediante el certificado que se va a renovar. El certificado debe codificarse mediante reglas de codificación distinguida (DER).

Sintaxis

HRESULT InitializeEncode(
  [in] EncodingType Encoding,
  [in] BSTR         strCert
);

Parámetros

[in] Encoding

Valor de enumeración EncodingType que especifica el tipo de codificación Unicode aplicada al certificado contenido en el parámetro strCert .

[in] strCert

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. Al hacerlo, 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 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 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.

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 de notación de sintaxis abstracta codificada (ASN.1) 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

   
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