Compartir a través de


Método IX500DistinguishedName::D ecode (certenroll.h)

El método Decode inicializa el objeto a partir de un nombre distintivo codificado unicode.

Sintaxis

HRESULT Decode(
  [in] BSTR          strEncodedName,
  [in] EncodingType  Encoding,
  [in] X500NameFlags NameFlags
);

Parámetros

[in] strEncodedName

Variable BSTR que contiene el nombre codificado.

[in] Encoding

Valor de enumeración EncodingType que especifica el tipo de codificación Unicode aplicada a la cadena de entrada. El valor predeterminado es XCN_CRYPT_STRING_BASE64.

[in] NameFlags

Valor de enumeración X500NameFlags que especifica el formato de la cadena descodificada.

Nota Las marcas siguientes se establecen automáticamente:
  • El valor predeterminado especificado en Certenroll.h es XCN_CERT_NAME_STR_NONE.
  • Si no especifica XCN_CERT_NAME_STR_FORWARD_FLAG, se aplicará automáticamente XCN_CERT_NAME_STR_REVERSE_FLAG.
  • Si no especifica XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG, se aplicará automáticamente XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG.
  • XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG se establece automáticamente independientemente de cualquier otra marca que especifique.
 

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
E_OUTOFMEMORY
No se pudo asignar memoria para el valor descodificado.
E_POINTER
El parámetro strEncodedName no puede ser NULL.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
No se pudo descodificar el nombre.

Comentarios

Este método llama internamente a la función CryptoAPI CertNameToStr . Llame a la propiedad Name para recuperar el nombre como una cadena de caracteres terminada en NULL. Llame a la propiedad EncodedName para recuperar una cadena que contiene un nombre codificado.

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

IX500DistinguishedName