Método IX509ExtensionAlternativeNames::InitializeEncode (certenroll.h)
El método InitializeEncode inicializa la extensión de una colección IAlternativeNames .
Sintaxis
HRESULT InitializeEncode(
[in] IAlternativeNames *pValue
);
Parámetros
[in] pValue
Puntero a una interfaz IAlternativeNames .
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 |
|---|---|
|
El objeto ya se ha inicializado. |
Comentarios
El método asocia la colección de nombres a la XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17) identificador de objeto (OID) y la codifica mediante reglas de codificación distinguida (DER).
Debe llamar a InitializeEncode o InitializeDecode para poder usar un objeto IX509ExtensionAlternativeNames . Los dos métodos se complementan entre sí. El método InitializeEncode permite construir un objeto de extensión de notación de sintaxis abstracta con codificación DER (ASN.1) a partir de datos sin procesar y el método InitializeDecode permite inicializar los datos sin procesar a partir de un objeto codificado.
Puede recuperar las siguientes propiedades para esta extensión:
- La propiedad Critical identifica si la extensión es crítica. También puede especificar esta propiedad.
- La propiedad ObjectId recupera el OID.
- La propiedad AlternativeNames recupera la colección de nombres (los datos de extensión 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 |