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

아티클
08/22/2023

GetLastStatus 메서드는 이 요청에 대한 마지막 반환 코드를 가져옵니다. 이렇게 하면 요청의 처리가 아닌 오류 코드 정보가 반환됩니다.

구문

HRESULT GetLastStatus(
  [out] LONG *pStatus
);

매개 변수

[out] pStatus

요청의 상태 코드에 대한 포인터입니다.

반환 값

C++

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

이 함수가 성공적으로 완료되면 *pStatus는 ICertRequest3::Submit, ICertRequest3::RetrievePending 또는 ICertRequest3::GetCACertificate에 대한 최신 호출의 결과 코드로 설정됩니다.

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

VB

반환 값은 CCertRequest3.Submit, CCertRequest3.RetrievePending 또는 CCertRequest3.GetCACertificate에 대한 최신 호출의 결과 코드입니다.

설명

GetLastStatus에서 검색하는 값은 ICertRequest3::Submit, ICertRequest3::RetrievePending 또는 ICertRequest3::GetCACertificate에 대한 최신 호출에 따라 달라집니다. 서버에서 이러한 메서드 중 하나에 대한 호출이 실패하면 GetLastStatus 를 호출하여 오류 번호를 검색합니다. 일부 서버 오류(예: 거부된 요청)는 메서드 호출에서 CR_DISP_ISSUED 이외의 처리 및 S_OK 반환하며 GetLastStatus 를 사용하여 특정 실패 원인을 검색할 수 있습니다. 이러한 메서드 중 하나에 대한 호출이 성공하면 GetLastStatus 에 대한 후속 호출은 S_OK(0)을 반환합니다.

또한 요청 처리는 인증서 서비스 데이터베이스에 저장되며 인증 기관 MMC 스냅인(요청 처리 열 선택)을 통해 볼 수 있습니다.

예제

HRESULT    hrServer, hr;
// pCertRequest is previously instantiated
// ICertRequest object pointer.
hr = pCertRequest->GetLastStatus((LONG *) &hrServer);
if (FAILED(hr))
{
    printf("Failed GetLastStatus [%x]\n", hr);
    goto error;
}
else
{
    // Use the HRESULT value as needed...
}

요구 사항

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