Compartir a través de

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

  • Artículo

El método Initialize inicializa la propiedad a partir del identificador de solicitud de certificado, la cadena de configuración de la entidad de certificación (CA) y un nombre para mostrar de certificado opcional.

Sintaxis

HRESULT Initialize(
  [in]           LONG RequestId,
  [in]           BSTR strCADnsName,
  [in]           BSTR strCAName,
  [in, optional] BSTR strFriendlyName
);

Parámetros

[in] RequestId

Variable LONG que contiene el identificador de solicitud de certificado. El proceso de inscripción crea un identificador de solicitud. Puede recuperar este valor llamando a la propiedad RequestId en la interfaz IX509Enrollment .

[in] strCADnsName

Variable BSTR que contiene el nombre del Sistema de nombres de dominio (DNS) de la ENTIDAD de certificación. Este es el nombre de la cadena de configuración CADnsName\CAName CAName . La cadena de configuración se establece normalmente durante el proceso de inscripción. El nombre DNS se puede recuperar llamando a la propiedad CAConfigString y separando la cadena en sus partes constituyentes.

[in] strCAName

Variable BSTR que contiene el nombre común del firmante (CN) de la ENTIDAD de certificación. Este es el segundo nombre de la cadena de configuración CADnsName\CAName CAName . La cadena de configuración se establece normalmente durante el proceso de inscripción. El nombre CN se puede recuperar llamando a la propiedad CAConfigString y separando la cadena en sus partes constituyentes.

[in, optional] strFriendlyName

Variable BSTR que contiene un nombre para mostrar opcional para el certificado. El valor predeterminado es NULL. Este valor se establece normalmente durante el proceso de inscripción. Para recuperarlo, llame a la propiedad CertificateFriendlyName .

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

Los valores que puede usar para inicializar el objeto ICertPropertyEnrollment se establecen durante el proceso de inscripción de certificados cuando el cliente llama al método Enroll en el objeto IX509Enrollment . Es decir, para recuperar un identificador de solicitud, llame a la propiedad RequestId en el objeto IX509Enrollment . Para recuperar un nombre para mostrar del certificado, llame a la propiedad CertificateFriendlyName . Para recuperar un nombre distintivo y un nombre común, llame a la propiedad CAConfigString y separe la cadena de configuración en sus partes constituyentes.

Llame al método SetValueOnCertificate para asociar la propiedad a un certificado. También puede llamar a las siguientes propiedades para recuperar los valores especificados durante la inicialización:

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

ICertProperty

ICertPropertyEnrollment