iCertEncodeAltName：：GetNameChoice 方法 (certenc.h)

GetNameChoice 方法返回备用名称数组的指定索引处的名称选择。

语法

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

[in] NameIndex

指定备用名称项的索引。第一个条目位于索引零处。

[out] pNameChoice

指向接收名称选择说明符的 LONG 的指针。

如果该方法成功，该方法将返回S_OK，并且 pNameChoice 参数指向指示备用名称类型的值。这是以下值之一。

如果方法失败，它将返回指示错误的 HRESULT 值。有关常见错误代码的列表，请参阅常见 HRESULT 值。

返回值是指定索引处的名称选择。名称选择指示备用名称的类型，以便可以正确使用它。必须是以下值之一。

返回代码	说明
CERT_ALT_NAME_DIRECTORY_NAME	该名称是目录名称。
CERT_ALT_NAME_DNS_NAME	该名称是一个 IA5 字符串，其中包含 DNS (域名系统) 名称，格式为 Host。实体。域。
CERT_ALT_NAME_IP_ADDRESS	名称是表示 Internet 协议地址的八进制字符串。
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 组成。