ICertificatePolicy
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
証明書を使用できる目的を識別する証明書ポリシーを指定するために使用できます。
メソッド 3
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
オブジェクト識別子 (OID) からオブジェクトを初期化します。
| pValue | IObjectId* | inoptional | OID を表す IObjectId インターフェイスへのポインター。 |
戻り値
関数が成功した場合、S_OK を返します。
関数が失敗した場合、エラーを示す HRESULT 値を返します。使用される値には、以下の表に示すものが含まれますが、これらに限定されません。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。
| 戻り値/値 | 説明 |
|---|---|
| IObjectId インターフェイスへのポインターが NULL です。 | |
|
オブジェクトは既に初期化されています。 |
解説(Remarks)
このメソッドを呼び出すときは、初期化済みの IObjectId オブジェクトを使用する必要があります。IObjectId のすべての初期化メソッドは、指定された初期化パラメーターに一致する最初の OID を、ローカルコンピューター上のレジストリおよび静的メモリ、ならびにドメインサーバー上の Active Directory から検索します。OID は ObjectId プロパティを呼び出して取得できます。
Initialize メソッドを呼び出すと、空の IPolicyQualifiers オブジェクトが作成されます。このオブジェクトは PolicyQualifiers プロパティを呼び出して取得できます。CertificatePolicies 拡張を作成する場合、このオブジェクトを使用してポリシー修飾子を定義できます。
ポリシーオブジェクトのオブジェクト識別子 (OID) を取得します。
| ppValue | IObjectId** | out | 証明書ポリシーを識別する IObjectId へのポインタを受け取る出力先である。 |
解説(Remarks)
IObjectId オブジェクトは、OID に関する情報を CryptoAPI の CRYPT_OID_INFO 構造体に内部的に格納します。この構造体を Certificate Enrollment API から直接使用することはできませんが、IObjectId インターフェイスを使用して、OID の表示名やドット区切りの十進名、または CERTENROLL_OBJECTID 値を取得できます。
証明書ポリシーに適用できるオプションのポリシー修飾子のコレクションを取得します。
| ppValue | IPolicyQualifiers** | out | このポリシーに関連付けられたポリシー修飾子のコレクション (IPolicyQualifiers) へのポインタを受け取る出力先である。 |
解説(Remarks)
Initialize メソッドを呼び出すと、空の IPolicyQualifiers オブジェクトが作成されます。PolicyQualifiers プロパティを呼び出してこのオブジェクトを取得し、ポリシーの修飾情報を指定できます。ポリシー修飾子は、CertificatePolicies 拡張を作成する場合にのみ適用されます。詳細については、IX509ExtensionCertificatePolicies を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ICertificatePolicy "{728AB31E-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global ICertificatePolicy IID_ICertificatePolicy "{}"
#comfunc global ICertificatePolicy_Initialize 7 sptr
#comfunc global ICertificatePolicy_get_ObjectId 8 sptr
#comfunc global ICertificatePolicy_get_PolicyQualifiers 9 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。