ICertEncodeAltName：：GetNameChoice 方法 (certenc.h)

GetNameChoice 方法會在替代名稱陣列的指定索引處傳回名稱選擇。

語法

HRESULT GetNameChoice(
  [in]  LONG NameIndex,
  [out] LONG *pNameChoice
);

[in] NameIndex

指定替代名稱專案的索引。第一個項目位於索引零。

[out] pNameChoice

LONG 的指標，可接收名稱選擇規範。

如果方法成功，方法會傳回S_OK，而 pNameChoice 參數會指向指出替代名稱類型的值。這是下列其中一個值。

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

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

傳回碼	Description
CERT_ALT_NAME_DIRECTORY_NAME	此名稱為目錄名稱。
CERT_ALT_NAME_DNS_NAME	此名稱是 IA5 字串，其格式為 Host，其中包含 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 格式的 URL。
CERT_ALT_NAME_OTHER_NAME	名稱是由 OID 和二進位 BLOB 所組成。