IX500DistinguishedName：:D ecode 方法 (certenroll.h)

Decode 方法會從 Unicode 編碼的辨別名稱初始化物件。

語法

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

[in] strEncodedName

包含編碼名稱的 BSTR 變數。

[in] Encoding

EncodingType 列舉值，指定套用至輸入字串的 Unicode 編碼類型。預設值為 XCN_CRYPT_STRING_BASE64。

[in] NameFlags

X500NameFlags 列舉值，指定譯碼字串的格式。

注意系統會自動設定下列旗標：

Certenroll.h 中指定的預設值 XCN_CERT_NAME_STR_NONE。
如果您未指定XCN_CERT_NAME_STR_FORWARD_FLAG，則會自動套用XCN_CERT_NAME_STR_REVERSE_FLAG。
如果您未指定XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG，則會自動套用XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG。
不論您指定的任何其他旗標為何，都會自動設定XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG。

如果函式成功，函式會傳回 S_OK。

如果函式失敗，它會傳回 HRESULT 值，指出錯誤。可能的值包括 (但不限於) 下表中的這些值。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

傳回碼/值	Description
E_OUTOFMEMORY	記憶體無法配置給譯碼的值。
E_POINTER	strEncodedName 參數不可為 NULL。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	無法譯碼名稱。

這個方法會在內部呼叫 CryptoAPI CertNameToStr 函式。呼叫 Name 屬性，以將名稱擷取為 Null 終止字元字串。呼叫 EncodedName 屬性，以擷取包含編碼名稱的字串。