IX500DistinguishedName::Decode method (certenroll.h)
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.
- 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 |
---|---|
|
Memory could not be allocated for the decoded value. |
|
The strEncodedName parameter cannot be NULL. |
|
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 |