Método ISignerCertificate::Initialize (certenroll.h)

El método Initialize inicializa el objeto a partir de un certificado de firma.

Syntax

HRESULT Initialize(
  [in] VARIANT_BOOL         MachineContext,
  [in] X509PrivateKeyVerify VerifyType,
  [in] EncodingType         Encoding,
  [in] BSTR                 strCertificate
);

Parámetros

[in] MachineContext

Variable VARIANT_BOOL que indica si se va a buscar el contexto del almacén de certificados del equipo local o el contexto de usuario para buscar el certificado identificado por el parámetro strCertificate . Especifique VARIANT_TRUE para el equipo y VARIANT_FALSE para el usuario.

[in] VerifyType

Valor de enumeración X509PrivateKeyVerify que especifica si se debe comprobar la clave privada utilizada para firmar el certificado y, si es así, si la comprobación debe ser silenciosa o permitir la entrada del usuario.

[in] Encoding

Valor de enumeración EncodingType que especifica el tipo de codificación Unicode aplicada a la cadena de certificado codificada con reglas de codificación distintivos (DER).

[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.

Observaciones

El método Initialize :

• Comprueba si existe la clave privada asociada al certificado.
• Crea un objeto IX509SignatureInformation y lo asigna al objeto ISignerCertificate .
• Recupera el algoritmo de clave pública de la clave privada.
• Asigna el algoritmo de clave pública al objeto IX509SignatureInformation .

Establezca las siguientes propiedades antes de llamar a Initialize:

• ParentWindow
• Anclar
• Silent
• UIContextMessage

Requisitos

Consulte también

ISignerCertificate