Método IX500DistinguishedName::D ecode (certenroll.h)
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.
- 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 |
---|---|
|
Não foi possível alocar memória para o valor decodificado. |
|
O parâmetro strEncodedName não pode ser NULL. |
|
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 |