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

아티클
02/26/2024

Next 메서드는 행 열거형 시퀀스의 다음 행으로 이동합니다.

구문

HRESULT Next(
  [out] LONG *pIndex
);

매개 변수

[out] pIndex

참조되는 다음 행의 인덱스 값을 포함하는 변수에 대한 포인터입니다. 열거할 행이 더 이상 없으면 이 변수는 –1로 설정됩니다. pIndex가 NULL이면 이 메서드가 실패합니다.

반환 값

C++

메서드가 성공하면 메서드는 S_OK 반환하고 다음 행은 이제 행 열거형 시퀀스에서 참조됩니다. 열거할 행이 더 이상 없으면 S_FALSE 반환되고 pIndex 는 –1 값으로 설정됩니다.

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

VB

반환 값은 현재 행 열거형 시퀀스에서 참조되는 행의 인덱스 값입니다. 열거할 행이 더 이상 없으면 반환 값은 –1입니다.

설명

이 메서드가 성공적으로 완료되면 다음 인터페이스의 메서드를 사용하여 행의 인증서와 연결된 열, 특성 및 확장을 열거할 수 있습니다.

관련된 쿼리와 시퀀스의 크기에 따라 열거형 시퀀스의 모든 행을 반복하는 것은 계산에 리소스를 많이 사용할 수 있습니다.

예제

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG  Index;
LONG  nCount;

// Ensure enumerator is at first row.
if (FAILED(pEnumRow->Reset()))
    printf("Failed to Reset\n");
else
{
    nCount = 0;
    // Count the database records by enumerating the rows.
    while (S_OK == pEnumRow->Next(&Index))
        nCount++;
    // Display number of records.
    printf("Number of records is %d\n", nCount);
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	certview.h(Certsrv.h 포함)
라이브러리	Certidl.lib
DLL	Certadm.dll