Método IX509CertificateRequest::Initialize (certenroll.h)
El método Initialize inicializa el objeto de solicitud para un usuario o un equipo.
Sintaxis
HRESULT Initialize(
[in] X509CertificateEnrollmentContext Context
);
Parámetros
[in] Context
Valor de enumeración X509CertificateEnrollmentContext que especifica si el certificado está pensado para un usuario final, un equipo o un administrador que actúa en nombre de un equipo. Puede ser uno de los valores siguientes.
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 devuelto | Descripción |
|---|---|
|
El objeto ya se ha inicializado. |
Comentarios
El método Initialize inicializa varios objetos en función del tipo de solicitud de certificado que se va a crear. Si llama a este método desde un objeto IX509CertificateRequestPkcs10 , se crea un objeto de clave privada y se inicializan los objetos siguientes:
- Colección ICryptAttributes vacía.
- Colección IX509Extensions vacía.
- Colección IObjectIds que contiene los identificadores de objeto de extensión críticos predeterminados, XCN_OID_KEY_USAGE y XCN_OID_BASIC_CONSTRAINTS2. Esta colección se puede recuperar llamando a la propiedad CriticalExtensions .
- Colección IObjectIds vacía para la propiedad SuppressOids .
- Objeto ICspInformations que contiene los valores especificados en la propiedad CSPInformations o en una colección de todos los proveedores instalados en el equipo. Esta colección se usa para crear una clave privada.
Si llama a este método desde un objeto IX509CertificateRequestCmc , se crea una solicitud PKCS #10 interna como antes y se inicializan los objetos siguientes:
- Colección ICryptAttributes vacía.
- Colección IX509NameValuePairs vacía.
- Colección IX509Extensions vacía.
- Colección IObjectIds que contiene los identificadores de objeto de extensión críticos predeterminados, XCN_OID_KEY_USAGE y XCN_OID_BASIC_CONSTRAINTS2. Esta colección se puede recuperar llamando a la propiedad CriticalExtensions .
- Colección IObjectIds vacía para la propiedad SuppressOids .
- Colección ISignerCertificates vacía.
Si llama a este método desde un objeto IX509CertificateRequestPkcs7 , se crea una solicitud PKCS #10 interna como se indicó anteriormente.
Se puede llamar a las siguientes propiedades antes de llamar a este método.
Debe llamar a la propiedad CSPInformations antes de llamar a este método si desea especificar una colección ICspInformations .
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 |