ICertRequest2::GetIssuedCertificate 메서드(certcli.h)

GetIssuedCertificate 메서드는 요청 ID 또는 인증서 일련 번호를 지정하여 인증서의 처리를 검색합니다.

이 메서드는 ICertRequest3::RetrievePending을 호출하는 것과 사실상 동일하며, 해당 인증서에 대한 일련 번호를 지정하는 추가 기능이 있습니다.

구문

HRESULT GetIssuedCertificate(
  [in]          const BSTR strConfig,
  [in]          LONG       RequestId,
  [in]          const BSTR strSerialNumber,
  [out, retval] LONG       *pDisposition
);

매개 변수

[in] strConfig

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

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

[in] RequestId

Certificates Services 데이터베이스의 인증서 요청 ID를 나타내는 LONG 값입니다. 요청 ID 대신 일련 번호( strSerialNumber로 전달됨)를 사용하는 경우 이 값에 –1을 사용합니다.

[in] strSerialNumber

CA에서 발급한 인증서 일련 번호를 나타내는 BSTR 값입니다. strSerialNumber를 사용하려면 RequestId에 –1 값을 지정해야 합니다.

[out, retval] pDisposition

인증서의 처리를 나타내는 LONG 값에 대한 포인터입니다. 처리는 다음 값 중 하나입니다.

값	의미
CR_DISP_DENIED	요청이 거부되었습니다.
CR_DISP_ERROR	요청이 실패했습니다.
CR_DISP_INCOMPLETE	요청이 완료되지 않았습니다.
CR_DISP_ISSUED	인증서가 발급되었습니다.
CR_DISP_ISSUED_OUT_OF_BAND	별도로 발급된 인증서입니다.
CR_DISP_UNDER_SUBMISSION	제출 중인 요청입니다.

반환 값

C++

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

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

VB

반환 값은 인증서의 처리를 나타내는 Long 입니다.

요구 사항

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