IOCSPAdmin::GetConfiguration 메서드(certadm.h)

GetConfiguration 메서드는 OCSP(온라인 인증서 상태 프로토콜) 응답자 서버에 연결하고 서버의 구성 정보를 사용하여 OCSPAdmin 개체를 초기화합니다.

구문

HRESULT GetConfiguration(
  [in] const BSTR   bstrServerName,
  [in] VARIANT_BOOL bForce
);

매개 변수

[in] bstrServerName

응답자 서버 이름을 포함하는 문자열입니다.

[in] bForce

C++	VARIANT_TRUE 호출자가 OCSP 응답자 서비스의 실행 중인 instance 찾을 수 없을 때 서버 레지스트리에서 응답자 구성을 읽으려는 경우 이고, 그렇지 않으면 VARIANT_FALSE.
VB	OCSP 응답자 서비스의 실행 중인 instance 찾을 수 없을 때 호출자가 서버 레지스트리에서 응답자 구성을 읽으려는 경우 True이면 이고, 그렇지 않으면 False입니다.

반환 값

VB

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

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

메서드가 HRESULT_FROM_WIN32(ERROR_INVALID_STATE)을 반환하면 구성이 이미 초기화됩니다.

메서드가 E_INVALIDARG 반환하면 pVal 매개 변수가 NULL로 설정됩니다.

설명

다음 표에서는 메서드 호출에 대한 bForce 매개 변수 값의 효과를 나열합니다.

대상 서버의 OCSP 응답자 서비스	bForce 가 VARIANT_TRUE	bForce 가 VARIANT_FALSE
실행 중	서비스에서 구성을 검색합니다.	서비스에서 구성을 검색합니다.
중지됨	서버 레지스트리에서 구성을 검색하려고 시도합니다. 이 시도가 실패하면 오류를 반환합니다.	오류를 반환합니다.

 

다음 표에서는 메서드 호출에 대한 bForce 매개 변수 값의 효과를 나열합니다.

대상 서버의 OCSP 응답자 서비스	bForce 는 True입니다.	bForce 는 False입니다.
실행 중	서비스에서 구성을 검색합니다.	서비스에서 구성을 검색합니다.
중지됨	서버 레지스트리에서 구성을 검색하려고 시도합니다. 이 시도가 실패하면 오류를 반환합니다.	오류를 반환합니다.

 

이 메서드는 OCSP 응답기 서비스의 실행 중인 instance 구성을 읽으려고 시도하지만 서비스가 실행되고 있지 않거나 액세스할 수 없는 상태인 경우 불가능할 수 있습니다. 호출자는 실행 중인 instance 찾을 수 없는 경우 서버 레지스트리에서 구성을 읽도록 메서드에 지시할 수 있습니다.

지정된 OCSPAdmin 개체에 대해 두 번 이상 호출하려고 하면 메서드가 실패합니다. OCSPAdmin의 각 instance 하나의 응답자 서버에 해당합니다. OCSP 응답기 서버 배열의 다른 서버에 연결하려면 OCSPAdmin 개체의 새 instance 만듭니다.

요구 사항

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

추가 정보

IOCSPAdmin