ICertAdmin インターフェイス (certadm.h)
ICertAdmin インターフェイスは、適切に承認されたクライアントの管理機能を提供します。
ICertAdmin インターフェイスは、次のタスクを実行するために使用されます。
- 証明書要求を承認または拒否します。
- 発行された証明書を取り消します。
- 証明書失効リスト (CRL) の生成をトリガーします。
- サーバーの現在の CRL を取得します。
- 証明書が有効かどうかを判断します。
ICertAdmin は Certadm.h で定義されています。 ただし、プログラムを作成するときは、インクルード ファイルとして Certsrv.h を使用します。 一方、Certadm.dll は ICertAdmin インターフェイスの実装を提供します。 このインターフェイスの型情報は、プラットフォーム ソフトウェア開発キット (SDK) に付属する Certadml.dll にも含まれています。
管理タスクでは DCOM を使用します。 以前のバージョンの Certadm.h で定義されているこのインターフェイス メソッドを呼び出すコードは、クライアントとサーバーの両方が同じ Windows オペレーティング システムを実行している限り、Windows ベースのサーバー上で実行されます。
Certificate Services インターフェイスは、アパートメント スレッディング モデルとフリー スレッド モデルの両方をサポートします。 スループットを向上させるために、空きスレッド処理をお勧めします。
継承
ICertAdmin インターフェイスは、IDispatch インターフェイスから継承します。 ICertAdmin には、次の種類のメンバーもあります。
メソッド
ICertAdmin インターフェイスには、これらのメソッドがあります。
| ICertAdmin::D enyRequest 保留中の指定された証明書要求を拒否します。 |
| ICertAdmin::GetCRL 証明書サービス証明機関 (CA) の現在の証明書失効リスト (CRL) を取得します。 |
| ICertAdmin::GetRevocationReason 証明書が取り消された理由を返します。 このメソッドは、最初に ICertAdmin インターフェイスで定義されました。 |
| ICertAdmin::ImportCertificate 以前に発行された証明書を取得し、証明機関の (CA) データベースにインポートします。 このメソッドは、最初に ICertAdmin インターフェイスで定義されました。 |
| ICertAdmin::IsValidCertificate 証明機関 (CA) キーに対して証明書を検証し、証明書が取り消されていないことを確認します。 このメソッドは、最初に ICertAdmin インターフェイスで定義されました。 |
| ICertAdmin::P ublishCRL 証明書サービス証明機関 (CA) に要求を送信して、新しい証明書失効リスト (CRL) を発行します。 このメソッドは、ICertAdmin インターフェイスで最初に導入されました。 |
| ICertAdmin::ResubmitRequest 指定した証明機関のポリシー モジュールに、指定した証明書要求を送信します。 このメソッドは、ICertAdmin インターフェイスで最初に導入されました。 |
| ICertAdmin::RevokeCertificate 指定した日付または直ちに証明書を取り消します。 このメソッドは、最初に ICertAdmin インターフェイスで定義されました。 |
| ICertAdmin::SetCertificateExtension 証明書要求に応答して発行された証明書に新しい拡張機能を追加します。 このメソッドは、最初に ICertAdmin インターフェイスによって定義されました。 |
| ICertAdmin::SetRequestAttributes 指定した保留中の証明書要求の属性を設定します。 このメソッドは、最初に ICertAdmin インターフェイスで定義されました。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | certadm.h (Certsrv.h を含む) |