ICertEncodeAltName：：SetNameEntry 方法 (certenc.h)

SetNameEntry 方法會在替代名稱陣列的指定索引處設定名稱。

使用此方法之前，您必須呼叫 ICertEncodeAltName：：Reset ，讓物件知道陣列中的元素數目。

語法

HRESULT SetNameEntry(
  [in] LONG       NameIndex,
  [in] LONG       NameChoice,
  [in] const BSTR strName
);

[in] NameIndex

以零起始的索引，指定要設定的替代名稱專案索引。

如果 NameChoice 參數CERT_ALT_NAME_OTHER_NAME，OR (|) EAN_NAMEOBJECTID (定义为0x80000000) 来设定 OID 的索引值。否則，會設定二進位值。

[in] NameChoice

指定名稱選擇。名稱選擇會指出替代名稱的類型，以便正確使用。它必須是下列其中一個值。

值	意義
CERT_ALT_NAME_DIRECTORY_NAME	此名稱為目錄名稱。
CERT_ALT_NAME_DNS_NAME	此名稱是 IA5 字串，以 host.entity.domain 格式指定 DNS (功能變數名稱系統) 名稱。
CERT_ALT_NAME_IP_ADDRESS	此名稱是代表因特網通訊協議位址的八位字串。
CERT_ALT_NAME_REGISTERED_ID	此名稱是 OID) (已註冊的物件識別碼。
CERT_ALT_NAME_RFC822_NAME	名稱是電子郵件位址。
CERT_ALT_NAME_URL	名稱是 IA5 字串，其格式為 Service：//HostName/Path。
CERT_ALT_NAME_OTHER_NAME	此名稱包含物件識別碼 (OID) 和二進位 BLOB。

[in] strName

指定替代名稱。

如果方法成功，方法會傳回S_OK。

如果方法失敗，它會傳回 HRESULT 值，指出錯誤。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。