ICertRequest インターフェイス (certcli.h)

ICertRequest インターフェイスは、クライアントまたは中間アプリケーションと証明書サービス間の通信を提供します。

クライアント アプリケーションと中間アプリケーションは 、ICertRequest メソッドを呼び出して、次のタスクを実行できます。

• 証明書要求を送信します。
• 要求の処理、最後の状態、識別子を取得します。
• 要求に対して発行された証明書を取得します。
• 以前の要求の保留中の証明書を取得します。
• Certificate Services サーバーの 証明機関 (CA) 証明書を取得します。

ICertRequest は Certcli.h で定義されています。 ただし、プログラムを作成するときは、インクルード ファイルとして Certsrv.h を使用します。 Certcli.dll は ICertRequest インターフェイスを提供します。 このインターフェイスの型情報は、プラットフォーム ソフトウェア開発キット (SDK) に付属する Certclil.dll にも含まれています。

Certificate Services インターフェイスは、アパートメント スレッディング モデルとフリー スレッド モデルの両方をサポートします。 スループットを向上させるために、無料スレッド処理をお勧めします。

継承

ICertRequest インターフェイスは IDispatch インターフェイスから継承されます。 ICertRequest には、次の種類のメンバーもあります。

メソッド

ICertRequest インターフェイスには、これらのメソッドがあります。

ICertRequest::GetCACertificate Certificate Services サーバーの証明機関 (CA) 証明書を返します。
ICertRequest::GetCertificate 要求に対して発行された証明書を X.509 証明書として返すか、必要に応じて公開キー暗号化標準 (PKCS) にパッケージ化して返します。
ICertRequest::GetDispositionMessage 証明書要求の現在の処理を示す、人間が判読できるメッセージを取得します。
ICertRequest::GetLastStatus この要求の最後のリターン コードを取得します。 これにより、要求の処理ではなく、エラー コード情報が返されます。
ICertRequest::GetRequestId 要求とその後の証明書の現在の内部要求番号を取得します。
ICertRequest::RetrievePending 以前にCR_DISP_INCOMPLETEまたはCR_DISP_UNDER_SUBMISSIONを返した可能性がある以前の要求から証明書の処理状態を取得します。
ICertRequest::Submit 証明書サービス サーバーに要求を送信します。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	certcli.h (Certsrv.h を含む)