ICertRequest::RetrievePending メソッド (certcli.h)

RetrievePending メソッドは、以前にCR_DISP_INCOMPLETEまたはCR_DISP_UNDER_SUBMISSIONを返した可能性がある以前の要求から証明書の処理状態を取得します。

結果の処理状態がCR_DISP_ISSUED場合は、 ICertRequest3::GetCertificate を呼び出して発行された証明書を取得できます。 CR_DISP_ISSUED以外の処理が返された場合は、詳細については、 ICertRequest3::GetLastStatus、 ICertRequest3::GetDispositionMessage、または両方のメソッドを呼び出します。

構文

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

パラメーター

[in] RequestId

以前にCR_DISP_INCOMPLETEまたはCR_DISP_UNDER_SUBMISSIONを返した要求の ID。

[in] strConfig

Certificate Services サーバーの有効な構成文字列を表します。 この文字列は、登録サーバーの HTTPS URL または ComputerName\CAName 形式で指定できます。 ComputerName はサーバーのネットワーク名で、 CAName は証明書サービスのセットアップ時に入力された 証明機関の共通名です。 構成文字列名の詳細については、「 ICertConfig」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: HTTPS URL は入力としてサポートされていません。

[out, retval] pDisposition

要求の処理値へのポインター。

戻り値

C++

この関数が正常に完了すると、*pDisposition は次の表のいずれかの値に設定されます。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

VB

注釈

このメソッドを正常に呼び出すと、EXITEVENT_CERTRETRIEVEPENDING イベントが生成されます。 ICertExit3::Initialize を呼び出すときに終了モジュールがこのイベントを指定した場合、アクティブな終了モジュールは (ICertExit3::Notify の呼び出しによって) このイベントの通知を受け取ります。

例

BSTR    bstrCA = NULL;
long    nReqID, nDisp;

// In this example, the request ID is hard-coded.
nReqID = 1234;

// Note use of two '\' in C++ to produce one '\'.
bstrCA = SysAllocString(L"server01\\myCAName");

// pCertRequest is previously instantiated ICertRequest
// object pointer. Retrieve the status for the specified request.
hr = pCertRequest->RetrievePending( nReqID, bstrCA, &nDisp );
if (FAILED(hr))
{
    printf("Failed RetrievePending [%x]\n", hr);
    goto error;
}
else
{
    // Use the disposition value as needed...
}
// Free BSTR resource.
if ( NULL != bstrCA )
    SysFreeString( bstrCA );

要件

こちらもご覧ください

CCertRequest

ICertConfig

ICertRequest

ICertRequest2

ICertRequest3