ICertRequest::GetCACertificate 메서드(certcli.h)

아티클
08/22/2023

GetCACertificate 메서드는 인증서 서비스 서버에 대한 CA(인증 기관) 인증서를 반환합니다.

구문

HRESULT GetCACertificate(
  [in]          LONG       fExchangeCertificate,
  [in]          const BSTR strConfig,
  [in]          LONG       Flags,
  [out, retval] BSTR       *pstrCertificate
);

매개 변수

[in] fExchangeCertificate

반환할 CA 인증서를 지정하는 부울 값입니다. fExchangeCertificate가 false로 설정된 경우 CA의 서명 인증서가 반환됩니다. CA의 서명 인증서를 사용하여 CA에서 발급한 인증서의 서명을 확인할 수 있습니다.

Windows Server 2003: fExchangeCertificate가 true로 설정되면 CA의 Exchange 인증서가 반환됩니다. CA의 Exchange 인증서를 사용하여 CA로 전송된 요청을 암호화할 수 있습니다.

Windows 7 및 Windows Server 2008 R2부터 이 매개 변수는 https:// 등록하는 동안 무시되며, 성공하면 항상 CA 교환 인증서를 반환합니다. 등록 웹 서비스에 대한 CA 서명 인증서를 검색하려면 CAPropCertificate EnrollmentCAProperty 열거형 값을 사용하여 ICertificationAuthority 인터페이스의 Property 메서드를 사용합니다.

TRUE는 C/C++ 프로그래머용으로 정의되고 Visual Basic은 True 키워드(keyword) 음수로 정의합니다. 따라서 Visual Basic 개발자는 True 대신 하나를 사용하여 이 매개 변수를 TRUE로 설정해야 합니다. 그러나 이 매개 변수를 FALSE로 설정하기 위해 Visual Basic 개발자는 0 또는 False를 사용할 수 있습니다.

[in] strConfig

Certificate Services 서버에 대한 유효한 구성 문자열을 나타냅니다. 이 문자열은 등록 서버의 HTTPS URL이거나 ComputerName\CAName 형식일 수 있습니다. 여기서 ComputerName 은 서버의 네트워크 이름이고 CAName 은 인증서 서비스 설정 중에 입력한 대로 인증 기관의 일반 이름입니다. 구성 문자열 이름에 대한 자세한 내용은 ICertConfig를 참조하세요.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: HTTPS URL은 입력으로 지원되지 않습니다.

[in] Flags

다음 플래그를 사용하여 반환된 인증서의 형식을 지정할 수 있습니다.

값	의미
CR_OUT_BASE64HEADER	시작/끝이 있는 BASE64 형식입니다.
CR_OUT_BASE64	시작/끝이 없는 BASE64 형식입니다.
CR_OUT_BINARY	이진 형식입니다.

다음 플래그를 형식 플래그와 결합하여 전체 인증서 체인을 요청된 CA 인증서에 포함하도록 지정할 수 있습니다. 그렇지 않으면 요청된 CA 인증서( X.509 형식)만 반환됩니다.

값	의미
CR_OUT_CHAIN	전체 인증서 체인을 PKCS #7에 포함합니다.

[out, retval] pstrCertificate

지정된 형식의 Certificate Services 서버에 대한 CA 인증서를 포함하는 BSTR 에 대한 포인터입니다.

반환 값

C++

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

이 메서드가 성공적으로 완료되면 *pstrCertificate 가 CA 인증서를 포함하는 BSTR 로 설정됩니다. 이 메서드를 사용하려면 BSTR 형식의 변수를 만들고, 변수를 NULL로 설정하고, 이 변수의 주소를 pstrCertificate로 전달합니다.

*pstrCertificate 사용을 마쳤으면 SysFreeString 함수를 호출하여 해제합니다.

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

VB

지정된 형식의 Certificate Services 서버에 대한 CA 인증서입니다.

설명

관리 작업은 DCOM을 사용합니다. 이전 버전의 Certadm.h에 정의된 대로 이 인터페이스 메서드를 호출하는 코드는 클라이언트와 서버가 모두 동일한 Windows 운영 체제를 실행하는 한 Windows 기반 서버에서 실행됩니다.

요구 사항


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