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 |