ICertView::OpenView 메서드(certview.h)

아티클
08/22/2023

OpenView 메서드는 Certificate Services 데이터베이스에 대한 보기를 열고 IEnumCERTVIEWROW 개체의 instance 인스턴스화합니다.

구문

HRESULT OpenView(
  [out] IEnumCERTVIEWROW **ppenum
);

매개 변수

[out] ppenum

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

반환 값

C++

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

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

VB

반환 값은 IEnumCERTVIEWROW 개체입니다.

설명

OpenView 메서드를 호출하기 전에 먼저 OpenConnection 메서드를 호출하여 인증서 서비스 서버와의 연결을 설정해야 합니다.

이 호출에서 반환된 IEnumCERTVIEWROW 개체는 내부 인덱스가 시퀀스의 시작을 가리키는 행 열거형 시퀀스를 나타냅니다. 시퀀스의 첫 번째 행을 보려면 다음을 호출합니다.
내부 인덱스가 첫 번째 행으로 이동하는 IEnumCERTVIEWROW::Next 메서드입니다.

기본이 아닌 열 집합 또는 행의 하위 집합을 보려면 OpenConnection을 호출한 후 OpenView를 호출하기 전에 SetResultColumnCount, SetResultColumn 및 SetRestriction을 호출합니다.

예제

// pCertView is previously instantiated pointer to ICertView.
IEnumCERTVIEWROW * pEnumRow = NULL;
HRESULT    hr;

hr = pCertView->OpenView(&pEnumRow);
if (S_OK != hr)
    printf("Failed ICertView::OpenView - %x\n", hr);
else
    // use pEnumRow as needed, to enumerate data rows
    // ...
// Done processing, free resources.
if (NULL != pEnumRow)
    pEnumRow->Release();

요구 사항


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