Compartilhar via


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

O método Encode inicializa o objeto de uma cadeia de caracteres que contém um nome diferenciado. Esse método está habilitado para a Web.

Sintaxe

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

Parâmetros

[in] strName

Uma variável BSTR que contém a cadeia de caracteres a ser codificada.

[in] NameFlags

Um valor de enumeração X500NameFlags que especifica o formato do valor codificado.

Nota Os seguintes sinalizadores são definidos automaticamente:
  • O valor padrão especificado em Certenroll.h é XCN_CERT_NAME_STR_NONE.
  • Se você não especificar XCN_CERT_NAME_STR_FORWARD_FLAG, XCN_CERT_NAME_STR_REVERSE_FLAG será aplicado automaticamente.
  • Se você não especificar XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG, XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG será aplicado automaticamente.
  • XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG é definido automaticamente independentemente de qualquer outro sinalizador especificado.
 

Valor retornado

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Valor/código retornado Descrição
E_OUTOFMEMORY
Não foi possível alocar memória para o valor codificado.
E_POINTER
O parâmetro strName não pode ser NULL.
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)
O comprimento, em caracteres do parâmetro strName , não pode exceder 64 * 1024.

Comentários

Esse método chama internamente a função CryptoAPI CertStrToName . Chame a propriedade Name para recuperar o nome como uma cadeia de caracteres terminada em nulo. Chame a propriedade EncodedName para recuperar uma cadeia de caracteres que contém um nome codificado.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certenroll.h
DLL CertEnroll.dll

Confira também

IX500DistinguishedName