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 字符串，指定 dns (域名系统) 名称，格式为 host.entity.domain。
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 组成。

[in] strName

指定备用名称。

如果该方法成功，该方法将返回S_OK。

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