IEnumCERTVIEWATTRIBUTE：：Next 方法 (certview.h)

项目
08/22/2023

Next 方法将移动到属性枚举序列中的下一个属性。

语法

HRESULT Next(
  [out] LONG *pIndex
);

参数

[out] pIndex

指向变量的指针，该变量包含所引用的下一个属性的索引值。如果没有其他要枚举的属性，则此变量设置为 –1。如果 pIndex 为 NULL，此方法将失败。

返回值

C++

如果该方法成功，该方法将返回S_OK，并且下一个属性现在正由特性枚举序列引用。如果没有其他属性，该方法将返回S_FALSE，并将 pIndex 设置为 –1 的值。

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

VB

返回值是属性枚举序列现在引用的属性的索引值。如果没有其他要枚举的属性，则返回值为 –1。

注解

成功完成此方法后，可以通过以下方法访问属性名称和值：

示例

LONG       Index;
HRESULT    hr;
BSTR       bstrAttribName = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
while (S_OK == pEnumAttr->Next(&Index))
{
    // retrieve the attribute name
    hr = pEnumAttr->GetName(&bstrAttribName);
    if (FAILED(hr))
        printf("Failed GetName -  %x\n", hr );
    else
        printf("Attribute name: %ws\n", bstrAttribName);
}

// Free resources.
if (NULL != bstrAttribName)
    SysFreeString(bstrAttribName);

要求

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