IEnumCERTVIEWROW：：EnumCertViewAttribute 方法 (certview.h)

项目
02/28/2024

EnumCertViewAttribute 方法获取行枚举序列的当前行的属性枚举序列实例。

语法

HRESULT EnumCertViewAttribute(
  [in]  LONG                   Flags,
  [out] IEnumCERTVIEWATTRIBUTE **ppenum
);

参数

[in] Flags

C++	LONG 值。必须为零。
VB	Long 值。必须为零。

[out] ppenum

指向 IEnumCERTVIEWATTRIBUTE 类型的指针的指针。成功完成此方法后， ppenum 设置为 IEnumCERTVIEWATTRIBUTE 类型的指针。

返回值

C++

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

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

VB

返回的值是一个属性枚举序列对象。

注解

此调用获取的属性枚举序列可用于枚举与当前行中的证书关联的属性。可以通过 IEnumCERTVIEWATTRIBUTE 接口的方法访问此枚举。

若要引用其他行，请调用以下方法之一以在行枚举序列中导航：

IEnumCERTVIEWROW：：Reset：移动到枚举序列的开头。
IEnumCERTVIEWROW：：Next：移动到枚举序列中的下一行。
IEnumCERTVIEWROW：：Skip：跳过指定数量的行。

示例

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT                  hr;
LONG                     Index;
IEnumCERTVIEWATTRIBUTE * pEnumAttr = NULL;

// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute(0, &pEnumAttr);
if (FAILED(hr))
{
    printf("Failed EnumCertViewAttribute - %x\n", hr);
    goto error;
}
// enumerate each attribute
while (S_OK == pEnumAttr->Next(&Index))
{
    // Use this attribute as needed.
}
error:

// Free resources.
if (NULL != pEnumAttr)
    pEnumAttr->Release();

要求

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