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

아티클
03/02/2024

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

구문

HRESULT EnumCertViewAttribute(
  [in]  LONG                   Flags,
  [out] IEnumCERTVIEWATTRIBUTE **ppenum
);

매개 변수

[in] Flags

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

[out] ppenum

IEnumCERTVIEWATTRIBUTE 형식의 포인터에 대한 포인터입니다. 이 메서드가 성공적으로 완료되면 ppenum 이 IEnumCERTVIEWATTRIBUTE 형식의 포인터로 설정됩니다.

반환 값

C++

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

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

VB

반환된 값은 특성 열거형 시퀀스 개체입니다.

설명

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

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

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

예제

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT                  hr;
LONG                     Index;
IEnumCERTVIEWATTRIBUTE * pEnumAttr = NULL;

// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute(0, &pEnumAttr);
if (FAILED(hr))
{
    printf("Failed EnumCertViewAttribute - %x\n", hr);
    goto error;
}
// enumerate each attribute
while (S_OK == pEnumAttr->Next(&Index))
{
    // Use this attribute as needed.
}
error:

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

요구 사항

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