다음을 통해 공유


IEnumCERTVIEWROW::GetMaxIndex 메서드(certview.h)

GetMaxIndex 메서드는 행 열거형 시퀀스의 모든 행을 참조한 후 유효한 최대 인덱스 값을 검색합니다.

구문

HRESULT GetMaxIndex(
  [out] LONG *pIndex
);

매개 변수

[out] pIndex

행 열거형 시퀀스의 최대 인덱스 값을 포함하는 LONG 변수에 대한 포인터입니다. pIndexNULL이면 이 메서드가 실패합니다.

반환 값

C++

메서드가 성공하면 메서드는 S_OK 반환하고 pIndex 는 행 열거형 시퀀스의 최대 인덱스 값으로 설정됩니다.

마지막 행으로의 트래버스가 발생하지 않으면 반환 값이 E_UNEXPECTED 이 메서드가 실패합니다.

메서드가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.

VB

반환 값은 행 열거형 시퀀스의 최대 인덱스 값입니다. 마지막 행으로의 트래버스가 발생하지 않으면 이 메서드가 실패합니다.

설명

이 메서드의 성공적인 완료는 열거형 시퀀스의 마지막 행에 도달하는 방법에 따라 달라집니다. 최대 행 인덱스는 스크롤 막대 또는 표시 창의 크기를 조정하는 데 유용할 수 있지만 전체 쿼리를 평가해야 하므로 계산에 리소스를 많이 사용할 수도 있습니다. 일부 쿼리의 경우 각 행에 대한 열 데이터를 검사하여 뷰에 포함되는지 여부를 확인해야 합니다. 사용자가 모든 데이터를 페이징하거나 명시적으로 끝까지 진행하도록 요청하면 최대 행 인덱스가 유지됩니다.

행 열거형 시퀀스를 탐색하려면 다음 메서드를 호출합니다.

메서드 Description
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 포함)
라이브러리 Certidl.lib
DLL Certadm.dll

추가 정보

IEnumCERTVIEWROW

IEnumCERTVIEWROW::Next

IEnumCERTVIEWROW::Reset

IEnumCERTVIEWROW::Skip