IEnumCERTVIEWEXTENSION::GetName 方法 (certview.h)
GetName 方法检索扩展枚举序列中当前扩展的名称。
返回的扩展名称是 OID) 字符串 (对象标识符 ,如 L“2.5.29.31”。
语法
HRESULT GetName(
[out] BSTR *pstrOut
);
参数
[out] pstrOut
指向包含扩展名称的 BSTR 类型的值的指针。
返回值
C++
如果方法成功,该方法将返回S_OK并将 pstrOut 参数设置为扩展的名称。若要使用此方法,请创建 BSTR 类型的变量,将变量设置为 等于 NULL,并将此变量的地址作为 pstrOut 传递。 使用完 BSTR 后,通过调用 SysFreeString 函数来释放它。
如果方法失败,它将返回一个 指示错误的 HRESULT 值。 有关常见错误代码的列表,请参阅 通用 HRESULT 值。
VB
返回值是包含扩展名称的 String 。注解
此函数用于检索扩展枚举序列当前引用的扩展的名称。
如果扩展枚举序列未引用有效的扩展, 则 GetName 将失败。 使用以下方法之一在枚举中导航:
- IEnumCERTVIEWEXTENSION::Reset:移动到枚举序列中的下一个扩展。
- IEnumCERTVIEWEXTENSION::Next:移动到枚举序列中的下一个扩展。
- IEnumCERTVIEWEXTENSION::Skip:跳过指定数量的扩展。
示例
BSTR bstrExtName = NULL;
// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
hr = pEnumExt->GetName(&bstrExtName);
if (S_OK == hr)
printf("Extension name is: %ws\n", bstrExtName);
else
printf("GetName failed: %x\n", hr);
// free memory when done
if (NULL != bstrExtName)
SysFreeString(bstrExtName);
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | certview.h (包括 Certsrv.h) |
Library | Certidl.lib |
DLL | Certadm.dll |
另请参阅
IEnumCERTVIEWEXTENSION::GetFlags