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

아티클
02/28/2024

EnumCertViewExtension 메서드는 행 열거형 시퀀스의 현재 행에 대한 확장 열거형 시퀀스의 instance 가져옵니다.

구문

HRESULT EnumCertViewExtension(
  [in]          LONG                   Flags,
  [out, retval] IEnumCERTVIEWEXTENSION **ppenum
);

매개 변수

[in] Flags

C++	LONG 값입니다. 0이어야 합니다.
VB	Long 값입니다. 0이어야 합니다.

[out, retval] ppenum

IEnumCERTVIEWEXTENSION 형식의 포인터에 대한 포인터입니다.

반환 값

C++

메서드가 성공하면 메서드는 S_OK 반환합니다.

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

VB

반환 값은 확장 열거형 시퀀스 개체입니다.

설명

이 호출에서 가져온 확장 열거형 시퀀스를 사용하여 현재 행의 인증서와 연결된 확장을 열거할 수 있습니다. 이 열거형은 IEnumCERTVIEWEXTENSION 인터페이스의 메서드를 통해 액세스할 수 있습니다.

다른 행을 참조하려면 다음 메서드 중 하나를 호출하여 행 열거형 시퀀스를 탐색합니다.

IEnumCERTVIEWROW::Reset: 열거형 시퀀스의 시작 부분으로 이동합니다.
IEnumCERTVIEWROW::Next: 열거형 시퀀스의 다음 행으로 이동합니다.
IEnumCERTVIEWROW::Skip: 지정된 수의 행을 건너뜁니다.

예제

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG       Index;
HRESULT    hr;
IEnumCERTVIEWEXTENSION * pEnumExt = NULL;
// Obtain enumerator for extensions.
hr = pEnumRow->EnumCertViewExtension(0, &pEnumExt);
if (FAILED(hr))
{
    printf("Failed EnumCertViewExtension - %x\n", hr);
    goto error;
}
// Enumerate each extension.
while (S_OK == pEnumExt->Next(&Index))
{
    // Use this extension as needed.
}
error:

// Free resources.
if (NULL != pEnumExt)
    pEnumExt->Release();

요구 사항

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