IX500DistinguishedName::Decode method (certenroll.h)

  • Article

The Decode method initializes the object from a Unicode-encoded distinguished name.

Syntax

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

Parameters

[in] strEncodedName

A BSTR variable that contains the encoded name.

[in] Encoding

An EncodingType enumeration value that specifies the type of Unicode encoding applied to the input string. The default value is XCN_CRYPT_STRING_BASE64.

[in] NameFlags

An X500NameFlags enumeration value that specifies the format of the decoded string.

Note  The following flags are set automatically:
  • The default value specified in Certenroll.h is XCN_CERT_NAME_STR_NONE.
  • If you do not specify XCN_CERT_NAME_STR_FORWARD_FLAG, then XCN_CERT_NAME_STR_REVERSE_FLAG is automatically applied.
  • If you do not specify XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG, then XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG is automatically applied.
  • XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG is automatically set regardless of any other flag you specify.
 

Return value

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. Possible values include, but are not limited to, those in the following table. For a list of common error codes, see Common HRESULT Values.

Return code/value Description
E_OUTOFMEMORY
 Memory could not be allocated for the decoded value.
E_POINTER
 The strEncodedName parameter cannot be NULL.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
 The name could not be decoded.

Remarks

This method internally calls the CryptoAPI CertNameToStr function. Call the Name property to retrieve the name as a null-terminated character string. Call the EncodedName property to retrieve a string containing an encoded name.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header certenroll.h
DLL CertEnroll.dll

See also

IX500DistinguishedName