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

  • Artigo

O método Decode inicializa o objeto de um nome diferenciado codificado em Unicode.

Sintaxe

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

Parâmetros

[in] strEncodedName

Uma variável BSTR que contém o nome codificado.

[in] Encoding

Um valor de enumeração EncodingType que especifica o tipo de codificação Unicode aplicada à cadeia de caracteres de entrada. O valor padrão é XCN_CRYPT_STRING_BASE64.

[in] NameFlags

Um valor de enumeração X500NameFlags que especifica o formato da cadeia de caracteres decodificada.

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.
 

Retornar valor

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 decodificado.
E_POINTER
 O parâmetro strEncodedName não pode ser NULL.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
 Não foi possível decodificar o nome.

Comentários

Esse método chama internamente a função CryptoAPI CertNameToStr . 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

Requisito Valor
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