Share via

ICertRequest3::GetIssuedCertificate2 메서드(certcli.h)

  • 아티클

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

구문

HRESULT GetIssuedCertificate2(
  [in]          BSTR strConfig,
  [in]          BSTR strRequestId,
  [in]          BSTR strSerialNumber,
  [out, retval] LONG *pDisposition
);

매개 변수

[in] strConfig

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

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

[in] strRequestId

Certificates Services 데이터베이스의 인증서 요청 ID를 나타내는 BSTR 값입니다. 요청 ID 대신 일련 번호(strSerialNumber로 전달됨)를 사용하는 경우 이 매개 변수를 NULL로 설정합니다.

ICertRequest3::GetRequestIdString 메서드를 사용하여 요청 ID 문자열을 가져옵니다.

[in] strSerialNumber

CA에서 발급한 인증서 일련 번호를 나타내는 BSTR 값입니다. 문자열은 일련 번호를 짝수 16진수로 지정해야 합니다. 필요한 경우 숫자 앞에 0을 접두사로 지정하여 짝수 자릿수를 생성할 수 있습니다. 그러나 앞에 오는 0을 둘 이상 사용할 수 없습니다.

strSerialNumber 값은 strRequestId가 NULL로 설정된 경우에만 사용됩니다.

[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 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 certcli.h(Certsrv.h 포함)
라이브러리 Certidl.lib
DLL Certcli.dll

추가 정보

CCertRequest

ICertRequest3