Compartir a través de

Método IX509ExtensionAlternativeNames::InitializeDecode (certenroll.h)

  • Artículo

El método InitializeDecode inicializa la extensión de una matriz de bytes codificada reglas de codificación distinguida (DER) que contiene el valor de extensión. La matriz de bytes codificada se representa mediante una cadena codificada unicode.

Sintaxis

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Parámetros

[in] Encoding

Valor de enumeración EncodingType que especifica el tipo de codificación Unicode aplicada al valor strEncodedData .

[in] strEncodedData

Variable BSTR que contiene la extensión codificada por DER.

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

Puede usar este método si tiene un objeto notación de sintaxis abstracta con codificación DER (ASN.1) que contiene una extensión AlternativeNames . Debe proporcionar el objeto codificado de DER en una cadena codificada unicode. Para obtener más información, consulte la interfaz IBinaryConverter .

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 ASN.1 codificado en 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 identificador de objeto (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

Consulte también

IX509ExtensionAlternativeNames