IEnumCERTVIEWROW::GetMaxIndex 方法 (certview.h)

引用行枚举序列中的所有行后, GetMaxIndex 方法检索最大有效索引值。

语法

HRESULT GetMaxIndex(
  [out] LONG *pIndex
);

参数

[out] pIndex

指向 LONG 变量的指针,该变量包含行枚举序列的最大索引值。 如果 pIndexNULL,此方法将失败。

返回值

C++

如果方法成功,该方法将返回S_OK并将 pIndex 设置为行枚举序列的最大索引值。

如果尚未遍历到最后一行,此方法将失败,返回值为 E_UNEXPECTED。

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

VB

返回值是行枚举序列的最大索引值。 如果尚未遍历到最后一行,此方法将失败。

注解

此方法的成功完成取决于是否到达枚举序列的最后一行。 最大行索引对于调整滚动条或显示窗口的大小很有用,但它也可能是计算资源密集型的,因为它需要评估整个查询。 对于某些查询,必须检查每行的列数据,以确定它是否包含在视图中。 当用户对所有数据进行分页或显式请求转到末尾后,将保留最大行索引。

若要浏览行枚举序列,请调用以下方法。

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

示例

#include <windows.h>
#include <stdio.h>
#include <Certview.h>

long nMax;

//  Determine the maximum row index.
hr = pRow->GetMaxIndex(&nMax);
if (FAILED(hr))
    printf("Failed GetMaxIndex [%x]\n", hr);
else
    printf("Max index is: %d\n", nMax);

要求

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

另请参阅

IEnumCERTVIEWROW

IEnumCERTVIEWROW::Next

IEnumCERTVIEWROW::Reset

IEnumCERTVIEWROW::Skip