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

아티클
02/23/2024

GetDispositionMessage 메서드는 인증서 요청의 현재 처리를 제공하는 사람이 읽을 수 있는 메시지를 가져옵니다.

여기에 반환된 메시지는 반환된 오류 코드보다 더 자세한 정보를 가질 수 있습니다. 예를 들어 ICertRequest3::GetLastStatus 는 HRESULT를 반환할 수 있지만 GetDispositionMessage 는 요청이 거부된 이유를 지정하는 자세한 이유를 반환합니다.

구문

HRESULT GetDispositionMessage(
  [out] BSTR *pstrDispositionMessage
);

매개 변수

[out] pstrDispositionMessage

처리 메시지를 포함하는 BSTR 에 대한 포인터입니다.

반환 값

C++

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

이 함수가 성공적으로 완료되면 *pstrDispositionMessage는 인증서 요청의 현재 처리를 제공하는 사람이 읽을 수 있는 메시지를 포함하는 BSTR로 설정됩니다. 이 메서드를 사용하려면 BSTR 형식의 변수를 만들고, 변수를 NULL로 설정하고, 이 변수의 주소를 pstrDispositionMessage로 전달합니다. BSTR 사용을 마쳤으면 SysFreeString 함수를 호출하여 해제합니다.

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

VB

반환 값은 인증서 요청의 현재 처리를 제공하는 사람이 읽을 수 있는 메시지를 포함하는 문자열입니다.

설명

애플리케이션은 ICertRequest3::Submit 또는 ICertRequest3::RetrievePending에 대한 이전 호출을 통해 서버에서 검색된 메시지를 가져오기 위해 이 메서드를 호출합니다. 또한 메시지는 Certificate Services 데이터베이스에 저장되며 인증 기관 MMC 스냅인(요청 처리 메시지 열 선택)에서 볼 수 있습니다. 메시지에 지역화된 텍스트가 포함된 경우 서버의 로캘에 따라 서버에서 지역화되었습니다.

예제

#include <windows.h>
#include <stdio.h>
#include <Certcli.h>

    BSTR    bstrDispMsg = NULL;
    // pCertRequest is previously instantiated ICertRequest object 
    // pointer. Retrieve the disposition message for the 
    // previous request.
    hr = pCertRequest->GetDispositionMessage(&bstrDispMsg);
    if (FAILED(hr))
    {
        printf("Failed GetDispositionMessage [%x]\n", hr);
        goto error;
    }
    else
    {
        // Use the disposition message as needed...
    }

    // Done processing.

error:

    // Free BSTR values.
    if (NULL != bstrCA)
        SysFreeString(bstrCA);

    if (NULL != bstrDispMsg)
        SysFreeString(bstrDispMsg);

요구 사항

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