Метод IEnumCERTVIEWROW::GetMaxIndex (certview.h)

Статья
08/22/2023

Метод GetMaxIndex извлекает максимально допустимое значение индекса после того, как будут ссылаться на все строки в последовательности перечисления строк.

Синтаксис

HRESULT GetMaxIndex(
  [out] LONG *pIndex
);

Параметры

[out] pIndex

Указатель на переменную LONG , содержащую максимальное значение индекса для последовательности перечисления строк. Этот метод завершается ошибкой , если pIndex имеет значение NULL.

Возвращаемое значение

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
Header	certview.h (включая Certsrv.h)
Библиотека	Certidl.lib
DLL	Certadm.dll

См. также раздел

IEnumCERTVIEWROW

IEnumCERTVIEWROW::Next

IEnumCERTVIEWROW::Reset

IEnumCERTVIEWROW::Skip

Поделиться через