Método IX500DistinguishedName::Encode (certenroll.h)

  • Artículo

El método Encode inicializa el objeto de una cadena que contiene un nombre distintivo. Este método está habilitado para web.

Sintaxis

HRESULT Encode(
  [in] BSTR          strName,
  [in] X500NameFlags NameFlags
);

Parámetros

[in] strName

Variable BSTR que contiene la cadena que se va a codificar.

[in] NameFlags

Valor de enumeración X500NameFlags que especifica el formato del valor codificado.

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, XCN_CERT_NAME_STR_REVERSE_FLAG se aplicará automáticamente.
  • Si no especifica XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG, XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG se aplicará automáticamente.
  • 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 codificado.
E_POINTER
 El parámetro strName no puede ser NULL.
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)
 La longitud, en caracteres del parámetro strName no puede superar los 64 * 1024.

Comentarios

Este método llama internamente a la función CryptoAPI CertStrToName . 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

   
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