ICertServerPolicy インターフェイス (certif.h)
ICertServerPolicy インターフェイスを使用すると、ポリシー モジュールは証明書サービスと通信できます。
メモ Certificate Services は、 ICertPolicy2 インターフェイスを介してポリシー モジュールと通信します。
- 後続の操作の現在のコンテキストとして使用する証明書要求を指定します。
- 証明書要求の拡張機能 (拡張フラグを含む) を列挙して取得し、発行された証明書の拡張機能を設定します。
- 要求属性を列挙して取得します。
- 証明書要求のプロパティを取得します。
- 証明書のプロパティを取得して設定します。
ICertPolicy::VerifyRequest メソッドが呼び出されてから返されるまで、未解決の要求と構築中の証明書に Context データ オブジェクトを介してアクセスできます。 ポリシー モジュールは ICertServerPolicy::SetCertificateProperty を呼び出すことによって要求プロパティに追加またはオーバーライドできるため、証明書のプロパティは要求プロパティとは異なる場合があります。
ICertServerPolicy は Certif.h で定義されています。 ただし、プログラムを作成するときは、インクルード ファイルとして Certsrv.h を使用します。 Certcli.dll ICertServerPolicy インターフェイスを提供します。 このインターフェイスの型情報は、プラットフォーム ソフトウェア開発キット (SDK) に付属する Certclil.dll にも含まれています。
Certificate Services インターフェイスは、アパートメント スレッディング モデルとフリー スレッド モデルの両方をサポートします。 スループットを向上させるために、空きスレッド処理をお勧めします。
継承
ICertServerPolicy インターフェイスは、IDispatch インターフェイスから継承されます。 ICertServerPolicy には、次の種類のメンバーもあります。
メソッド
ICertServerPolicy インターフェイスには、これらのメソッドがあります。
| ICertServerPolicy::EnumerateAttributes 現在の属性の名前を取得し、内部列挙ポインターを次の属性に移動します。 |
| ICertServerPolicy::EnumerateAttributesClose 属性列挙に接続されているリソースを解放します。 |
| ICertServerPolicy::EnumerateAttributesSetup 現在のコンテキストに関連付けられている最初の要求属性への内部列挙ポインターを初期化します。 (ICertServerPolicy.EnumerateAttributesSetup) |
| ICertServerPolicy::EnumerateExtensions 現在の拡張機能のオブジェクト識別子 (OID) を取得し、内部列挙ポインターを次の拡張機能に移動します。 |
| ICertServerPolicy::EnumerateExtensionsClose 拡張機能の列挙に接続されているリソースを解放します。 |
| ICertServerPolicy::EnumerateExtensionsSetup 現在のコンテキストに関連付けられている最初の証明書拡張機能への内部列挙ポインターを初期化します。 (ICertServerPolicy.EnumerateExtensionsSetup) |
| ICertServerPolicy::GetCertificateExtension 特定の証明書拡張機能を取得します。 |
| ICertServerPolicy::GetCertificateExtensionFlags GetCertificateExtension の最新の呼び出しによって取得された拡張機能に関連付けられているフラグを取得します。 |
| ICertServerPolicy::GetCertificateProperty 証明書から名前付きプロパティを返します。 (ICertServerPolicy.GetCertificateProperty) |
| ICertServerPolicy::GetRequestAttribute 要求から名前付き属性を返します。 |
| ICertServerPolicy::GetRequestProperty 要求から特定のプロパティを取得します。 |
| ICertServerPolicy::SetCertificateExtension 証明書に新しい拡張機能を追加します。 |
| ICertServerPolicy::SetCertificateProperty 証明書に関連付けられているプロパティを設定するには。 |
| ICertServerPolicy::SetContext 証明書サービスへの後続の呼び出しのコンテキストとして使用する要求を指定します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | certif.h (Certsrv.h を含む) |