IEnumCERTVIEWEXTENSION：：GetName 方法 (certview.h)

项目
02/26/2024

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