ICertRequest3 インターフェイス (certcli.h)
ICertRequest3 インターフェイスは、クライアントまたは中間アプリケーションと証明書サービス間の通信を提供する 3 つのインターフェイスのうちの 1 つです。
クライアント アプリケーションと中間アプリケーションは 、ICertRequest3 メソッドを呼び出して、次のタスクを実行できます。
- 証明書要求を送信します。
- 要求の処理、最後の状態、識別子を取得します。
- 要求に対して発行された証明書を取得します。
- 以前の要求の保留中の証明書を取得します。
- Certificate Services サーバーの 証明機関 (CA) 証明書を取得します。
- CA プロパティの値、表示名、および プロパティに関連付けられているフラグを取得します。
- サーバーによって返されるキャッシュされた応答データを取得します。
- HRESULT エラー コードのエラー メッセージ テキストを取得します。
ICertRequest3 は Certcli.h で定義されています。 ただし、プログラムを作成するときは、インクルード ファイルとして Certsrv.h を使用します。 Certcli.dll は ICertRequest3 インターフェイスを提供します。 このインターフェイスの型情報は、プラットフォーム ソフトウェア開発キット (SDK) に付属する Certcli.dll にも含まれています。
Certificate Services インターフェイスは、アパートメント スレッディング モデルとフリー スレッド モデルの両方をサポートします。 スループットを向上させるために、無料スレッド処理をお勧めします。
継承
ICertRequest3 インターフェイスは、ICertRequest2、ICertRequest、および IDispatch から継承されます。 ICertRequest3 には、次の種類のメンバーもあります。
メソッド
ICertRequest3 インターフェイスには、これらのメソッドがあります。
| ICertRequest3::GetIssuedCertificate2 要求 ID 文字列または証明書のシリアル番号を指定して、証明書の処理を取得します。 |
| ICertRequest3::GetRefreshPolicy クライアントのキャッシュされた証明書登録ポリシーが古く、更新する必要があるかどうかを示す値を返します。 |
| ICertRequest3::GetRequestIdString 要求とその後の証明書の文字列として書式設定された現在の内部要求番号を取得します。 |
| ICertRequest3::SetCredential 証明書登録 Web サービスへの接続に使用する資格情報を設定します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | certcli.h (Certsrv.h を含む) |