IX500DistinguishedName：：Encode 方法 (certenroll.h)

Encode方法會從包含辨別名稱的字串初始化物件。此方法已啟用 Web。

語法

HRESULT Encode(
  [in] BSTR          strName,
  [in] X500NameFlags NameFlags
);

[in] strName

BSTR變數，其中包含要編碼的字串。

[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	strName參數不可為Null。
HRESULT_FROM_WIN32 (ERROR_FILENAME_EXCED_RANGE)	strName參數的長度不能超過 64 * 1024。

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