Método IX509ExtensionTemplate::InitializeEncode (certenroll.h)

  • Artículo

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 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

Consulte también

IX509ExtensionTemplate