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

아티클
02/23/2024

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