iCertEncodeAltName::GetName 方法 (certenc.h)

GetName 方法从备用名称数组返回指定的名称。

语法

HRESULT GetName(
  [in]  LONG NameIndex,
  [out] BSTR *pstrName
);

参数

[in] NameIndex

一个从零开始的索引,指定要检索的备用名称条目的索引。

若要检索CERT_ALT_NAME_OTHER_NAME名称 (OID) 的对象标识符 ,请使用按位 OR 运算将索引值与定义为 0x80000000) 的EAN_NAMEOBJECTID (进行组合。 否则,将检索二进制值。 若要确定名称的类型,请调用 ICertEncodeAltName::GetNameChoice 方法。

[out] pstrName

指向接收备用名称的 BSTR 的指针。 使用完 BSTR 后,通过调用 SysFreeString 函数释放它。

返回值

C++

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

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

VB

返回值是指定索引处的备用名称。 返回值为 Unicode 字符串。

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 certenc.h (包括 Certsrv.h)
Library Certidl.lib
DLL Certenc.dll

另请参阅

ICertEncodeAltName

ICertEncodeAltName::GetNameChoice

ICertEncodeAltName::SetNameEntry