ICertAdmin::ResubmitRequest メソッド (certadm.h)

[アーティクル]
08/22/2023

ResubmitRequest メソッドは、指定した証明機関のポリシーモジュールに指定された証明書要求を送信します。このメソッドは、 ICertAdmin インターフェイスで最初に導入されました。

このメソッドを成功させるには、証明書要求が保留中である必要があります。

構文

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

パラメーター

[in] strConfig

COMPUTERNAME\CANAME 形式の証明機関 (CA) の有効な構成文字列を表します。COMPUTERNAME は証明書サービスサーバーのネットワーク名、CANAME は証明書サービスのセットアップ時に入力された証明機関の共通名です。構成文字列名の詳細については、「 ICertConfig」を参照してください。

重要ResubmitRequest は、構成文字列が変更されたときに内部キャッシュをクリアしません。 CA の構成文字列を変更する場合は、新しい ICertAdmin オブジェクトをインスタンス化し、新しい構成文字列を使用してこのメソッドを再度呼び出す必要があります。

[in] RequestId

再送信する要求の ID を指定します。

[out, retval] pDisposition

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

戻り値

C++

メソッドが成功し、 pDisposition パラメーターが、要求の処理を指定する次のいずれかの値に設定されている場合、メソッドは S_OKを返します。

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

VB

戻り値は、要求の処理を指定します。この値は、次のいずれかの値です。

リターンコード	説明
CR_DISP_INCOMPLETE	要求が完了していません。
CR_DISP_ERROR	要求が失敗しました。
CR_DISP_DENIED	要求は拒否されました。
CR_DISP_ISSUED	証明書が発行されました。
CR_DISP_ISSUED_OUT_OF_BAND	証明書は個別に発行されました。
CR_DISP_UNDER_SUBMISSION	要求は送信中に取得されました。

注釈

管理タスクでは DCOM が使用されます。以前のバージョンの Certadm.h で定義されているこのインターフェイスメソッドを呼び出すコードは、クライアントとサーバーの両方が同じ Windows オペレーティングシステムを実行している限り、Windows ベースのサーバーで実行されます。

例

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


    long nDisp;  // disposition value
    long nReqID = <REQUESTIDHERE>;
    BSTR bstrCA = NULL;

    bstrCA = SysAllocString(L"<COMPUTERNAMEHERE>\\<CANAMEHERE>");
    if (NULL == bstrCA)
    {
        printf("Memory allocation failed\n");
        goto error;
    }

    //  pCertAdmin is a previously instantiated ICertAdmin object.
    hr = pCertAdmin->ResubmitRequest(bstrCA, nReqID, &nDisp);
    if (FAILED(hr))
    {
        printf("Failed ResubmitRequest [%x]\n", hr);
        goto error;
    }
    else
        printf("ResubmitRequest disposition is %d\n", nDisp);

error:
    //  Free resources.
    if (bstrCA)
        SysFreeString(bstrCA);

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	certadm.h (Certsrv.h を含む)
Library	Certidl.lib
[DLL]	Certadm.dll