ホーム › Security.Cryptography.Certificates › IX509ExtensionMSApplicationPolicies

IX509ExtensionMSApplicationPolicies

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IID728ab321-217d-11da-b2a4-000e7bbb2b09継承元IX509Extension呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl12

公式ドキュメント

アプリケーションによって証明書をどのように使用できるかを示すオブジェクト識別子 (OID) のコレクションを指定できるようにします。

メソッド 3

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 12 HRESULT InitializeEncode(ICertificatePolicies* pValue)

ICertificatePolicies コレクションから拡張を初期化します。

pValue

ICertificatePolicies*

inoptional

ICertificatePolicies インターフェイスへのポインター。

戻り値

関数が成功すると、関数は S_OK を返します。

関数が失敗すると、エラーを示す HRESULT 値を返します。可能な値には次の表に示すものが含まれますが、これらに限定されません。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。

リターンコード/値	説明
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	オブジェクトは既に初期化されています。

解説(Remarks)

IX509ExtensionMSApplicationPolicies オブジェクトを使用する前に、InitializeEncode または InitializeDecode のいずれかを呼び出す必要があります。これら 2 つのメソッドは互いに補完し合います。InitializeEncode メソッドを使用すると、生データから Distinguished Encoding Rules (DER) でエンコードされた ASN.1 拡張オブジェクトを構築でき、InitializeDecode メソッドを使用すると、エンコードされたオブジェクトから生データを初期化できます。

この拡張については、次のプロパティを取得できます。

Critical プロパティは、拡張がクリティカルかどうかを識別します。このプロパティを指定することもできます。
ObjectId プロパティは、拡張のオブジェクト識別子 (OID) を取得します。
Policies プロパティは、証明書ポリシーのコレクション (生の拡張データ) を取得します。

vtbl 13 HRESULT InitializeDecode(EncodingType Encoding, LPWSTR strEncodedData)

拡張の値を含む Distinguished Encoding Rules (DER) でエンコードされたバイト配列から拡張を初期化します。(IX509ExtensionMSApplicationPolicies.InitializeDecode)

Encoding	EncodingType	in	strEncodedData 値に適用される Unicode エンコードの種類を指定する EncodingType 列挙値。
strEncodedData	LPWSTR	in	DER でエンコードされた拡張を含む BSTR 変数。

戻り値

関数が成功すると、関数は S_OK を返します。

リターンコード/値	説明
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	オブジェクトは既に初期化されています。

解説(Remarks)

CertificatePolicies 拡張を含む DER でエンコードされた Abstract Syntax Notation One (ASN.1) オブジェクトがある場合は、このメソッドを使用できます。DER でエンコードされたオブジェクトは Unicode エンコード文字列で指定する必要があります。詳細については、IBinaryConverter インターフェイスを参照してください。

IX509ExtensionMSApplicationPolicies オブジェクトを使用する前に、InitializeEncode または InitializeDecode のいずれかを呼び出す必要があります。これら 2 つのメソッドは互いに補完し合います。InitializeEncode メソッドを使用すると、生データから DER でエンコードされた ASN.1 拡張オブジェクトを構築でき、InitializeDecode メソッドを使用すると、エンコードされたオブジェクトから生データを初期化できます。

この拡張については、次のプロパティを取得できます。

Critical プロパティは、拡張がクリティカルかどうかを識別します。このプロパティを指定することもできます。
ObjectId プロパティは、拡張のオブジェクト識別子 (OID) を取得します。
Policies プロパティは、証明書ポリシーのコレクション (生の拡張データ) を取得します。

vtbl 14 HRESULT get_Policies(ICertificatePolicies** ppValue)

アプリケーションポリシーのコレクションを取得します。

ppValue

ICertificatePolicies**

out

拡張に含まれるアプリケーションポリシーのコレクション (ICertificatePolicies) へのポインタを受け取る出力先である。

解説(Remarks)

コレクションを初期化するには、InitializeEncode メソッドまたは InitializeDecode メソッドを呼び出します。また、Critical プロパティを呼び出して、拡張がクリティカルかどうかを識別するブール値を指定および取得することもでき、ObjectId プロパティを呼び出して、拡張に関連付けられたオブジェクト識別子 (OID) を取得できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IX509ExtensionMSApplicationPolicies "{728AB321-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global IX509ExtensionMSApplicationPolicies IID_IX509ExtensionMSApplicationPolicies "{}"
#comfunc global IX509ExtensionMSApplicationPolicies_InitializeEncode  12 sptr
#comfunc global IX509ExtensionMSApplicationPolicies_InitializeDecode  13 int,wstr
#comfunc global IX509ExtensionMSApplicationPolicies_get_Policies      14 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。