IEnumCERTVIEWATTRIBUTE::GetName 方法 (certview.h)

GetName 方法检索属性枚举序列中当前属性的名称。

语法

HRESULT GetName(
  [out] BSTR *pstrOut
);

参数

[out] pstrOut

指向包含属性名称的 BSTR 类型的变量的指针。

返回值

C++

如果方法成功,该方法将返回S_OK, 并且 pstrOut 参数包含 属性的名称。

若要使用此方法,请创建 BSTR 类型的变量,将变量设置为 等于 NULL,并将此变量的地址作为 pstrOut 传递。 使用完 BSTR 后,通过调用 SysFreeString 函数来释放它。

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

VB

返回值是包含特性名称的 String

注解

此方法用于检索属性枚举序列当前引用的属性的名称。

如果属性枚举序列未引用有效的属性, 则 GetName 将失败。 使用以下方法之一在枚举中导航:

示例

BSTR    bstrAttribName = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetName(&bstrAttribName);
if (S_OK != hr)
    printf("Failed call to GetName - %x\n", hr);
else
    printf("Attribute name is %ws\n", bstrAttribName );

// free memory when done
if (NULL != bstrAttribName)
    SysFreeString(bstrAttribName);

要求

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

另请参阅

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWATTRIBUTE::GetValue

IEnumCERTVIEWATTRIBUTE::Next

IEnumCERTVIEWATTRIBUTE::Reset

IEnumCERTVIEWATTRIBUTE::Skip