Método IX509ExtensionTemplate::InitializeEncode (certenroll.h)
El método InitializeEncode inicializa la extensión a partir de un identificador de objeto de plantilla (OID) y de los números de versión principal y secundaria. Este método está habilitado para web.
Sintaxis
HRESULT InitializeEncode(
[in] IObjectId *pTemplateOid,
[in] LONG MajorVersion,
[in] LONG MinorVersion
);
Parámetros
[in] pTemplateOid
Puntero a una interfaz IObjectId que representa el OID de plantilla.
[in] MajorVersion
Variable LONG que contiene el número de versión principal de la plantilla. El valor predeterminado es cero (0).
[in] MinorVersion
Variable LONG que contiene el número de versión secundaria de la plantilla. El valor predeterminado es cero (0).
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
Debe llamar a InitializeEncode o InitializeDecode para poder usar un objeto IX509ExtensionTemplate . Los dos métodos se complementan entre sí. El método InitializeEncode permite construir un objeto de extensión de sintaxis abstracta (ASN.1) codificado reglas de codificación distinguida (DER) a partir de datos sin procesar y el método InitializeDecode permite inicializar los datos sin procesar desde 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.
- Las propiedades MajorVersion y MinorVersion recuperan la información de la versión.
- La propiedad TemplateOid recupera el OID de la plantilla.
Debe llamar a InitializeEncode o InitializeDecode para poder usar un objeto IX509ExtensionBasicConstraints . Los dos métodos se complementan entre sí. El método InitializeEncode permite construir una estructura ASN.1 codificada a partir de datos sin procesar y el método InitializeDecode permite inicializar los datos sin procesar a partir de una estructura ASN.1 codificada. Puede recuperar los datos sin procesar de la extensión llamando a las propiedades MajorVersion, MinorVersion y TemplateOid .
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 |