ホーム › Security.Cryptography.Certificates › IPolicyQualifier

IPolicyQualifier

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

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

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

公式ドキュメント

証明書ポリシーに関連付けることができる修飾子(qualifier)を表します。

メソッド 5

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

vtbl 7 HRESULT InitializeEncode(LPWSTR strQualifier, PolicyQualifierType Type)

文字列と、修飾子の種類を識別する値からオブジェクトを初期化します。

strQualifier

LPWSTR

修飾子を格納する BSTR 変数。

Type

PolicyQualifierType

証明書ポリシーに適用される修飾子の種類を指定する PolicyQualifierType 列挙値。次のいずれかの値を指定できます。

値	意味
PolicyQualifierTypeUnknown	修飾子の種類が指定されていません。
PolicyQualifierTypeUrl	修飾子は、証明書が発行された際に適用されるポリシーと証明書を使用できる目的を概説するために証明機関(CA)が定義した、認証実施規程(Certification Practice Statement、CPS)を指す URL です。
PolicyQualifierTypeUserNotice	修飾子は、証明書に依拠するすべてのユーザーに対してアプリケーションが表示するテキストの記述です。このユーザー通知(user notice)は、証明書の許可された用途を示します。

戻り値

関数が成功した場合、S_OK を返します。

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

戻り値	説明
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	オブジェクトは既に初期化されています。

解説(Remarks)

Type パラメーターに PolicyQualifierTypeUrl を指定した場合、このメソッドは strQualifier パラメーターに入力された文字列を XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1) オブジェクト識別子 (OID) に関連付け、Distinguished Encoding Rules (DER) を使用してエンコードします。URL は Abstract Syntax Notation One (ASN.1) IA5 文字列としてエンコードされます。

Type パラメーターに PolicyQualifierTypeUserNotice を指定した場合、このメソッドは strQualifier パラメーターに入力された文字列を XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE (1.3.6.1.5.5.7.2.2) OID に関連付け、DER を使用してエンコードします。

このオブジェクトについては、次のプロパティを取得できます:

ObjectId プロパティは、修飾子が CPS とユーザー通知のいずれであるかを識別する OID を取得します。
Qualifier プロパティは、InitializeEncode メソッドの strQualifier パラメーターに指定された文字列を取得します。
RawData プロパティは、DER でエンコードされた修飾子を取得します。
Type プロパティは、修飾子の種類を指定する PolicyQualifierType 列挙値を取得します。

vtbl 8 HRESULT get_ObjectId(IObjectId** ppValue)

修飾子のオブジェクト識別子(OID)を取得します。

ppValue

IObjectId**

out

ポリシー修飾子の種別を表すオブジェクト識別子 (IObjectId) へのポインタを受け取る出力先である。

解説(Remarks)

InitializeEncode メソッドの Type パラメーターに PolicyQualifierTypeUrl を指定した場合は、XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1) が返されます。PolicyQualifierTypeUserNotice を指定した場合は、XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE (1.3.6.1.5.5.7.2.2) が返されます。

このプロパティを取得する前に、InitializeEncode を呼び出して修飾子オブジェクトを初期化する必要があります。このオブジェクトについては、次のプロパティも取得できます:

Qualifier プロパティは、InitializeEncode メソッドの strQualifier パラメーターに指定された文字列を取得します。
RawData プロパティは、Distinguished Encoding Rules (DER) でエンコードされた修飾子を取得します。
Type プロパティは、修飾子の種類を指定する PolicyQualifierType 列挙値を取得します。

vtbl 9 HRESULT get_Qualifier(LPWSTR* pValue)

オブジェクトの初期化に使用された修飾子を格納する文字列を取得します。

pValue

LPWSTR*

out

ポリシー修飾子の値を表す文字列を受け取る出力先である。

解説(Remarks)

このプロパティを取得する前に、InitializeEncode を呼び出して修飾子オブジェクトを初期化する必要があります。取得される値は、そのメソッドの strQualifier パラメーターに入力された文字列です。このオブジェクトについては、次のプロパティも取得できます:

ObjectId プロパティは、修飾子が CPS とユーザー通知のいずれであるかを識別するオブジェクト識別子 (OID) を取得します。
RawData プロパティは、Distinguished Encoding Rules (DER) でエンコードされた修飾子を取得します。
Type プロパティは、修飾子の種類を指定する PolicyQualifierType 列挙値を取得します。

vtbl 10 HRESULT get_Type(PolicyQualifierType* pValue)

修飾子の種類を取得します。

pValue

PolicyQualifierType*

out

ポリシー修飾子の種別を示す PolicyQualifierType 値を受け取る出力先である。

解説(Remarks)

このプロパティを取得する前に、InitializeEncode を呼び出して修飾子オブジェクトを初期化する必要があります。取得される値は、PolicyQualifierType 列挙の次の値のいずれかです。

値	説明
PolicyQualifierTypeUrl	修飾子は、認証実施規程(CPS)を指す URL です。
PolicyQualifierTypeUserNotice	修飾子は、証明書に依拠するユーザーに表示される文字列です。

このオブジェクトについては、次のプロパティも取得できます:

ObjectId プロパティは、修飾子が CPS とユーザー通知のいずれであるかを識別するオブジェクト識別子 (OID) を取得します。
Qualifier プロパティは、InitializeEncode メソッドの strQualifier パラメーターに指定された文字列を取得します。
RawData プロパティは、Distinguished Encoding Rules (DER) でエンコードされた修飾子を取得します。

vtbl 11 HRESULT get_RawData(EncodingType Encoding, LPWSTR* pValue)

Distinguished Encoding Rules (DER) でエンコードされた修飾子オブジェクトを取得します。

Encoding	EncodingType	in	出力する pValue の希望するエンコード形式を指定する EncodingType 値である。
pValue	LPWSTR*	out	指定エンコード形式によるポリシー修飾子の生データ (RAW) を受け取る出力先である。

解説(Remarks)

このプロパティを取得する前に、InitializeEncode を呼び出して修飾子オブジェクトを初期化する必要があります。取得される値は、修飾子を格納する DER でエンコードされたバイト配列です。バイト配列は文字列として表現されます。EncodingType 列挙を使用して、その文字列に Unicode エンコードを適用できます。

このオブジェクトについては、次のプロパティも取得できます:

ObjectId プロパティは、修飾子が CPS とユーザー通知のいずれであるかを識別するオブジェクト識別子 (OID) を取得します。
Qualifier プロパティは、InitializeEncode メソッドの strQualifier パラメーターに指定された文字列を取得します。
Type プロパティは、修飾子の種類を指定する PolicyQualifierType 列挙値を取得します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IPolicyQualifier "{728AB31C-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global IPolicyQualifier IID_IPolicyQualifier "{}"
#comfunc global IPolicyQualifier_InitializeEncode  7 wstr,int
#comfunc global IPolicyQualifier_get_ObjectId      8 sptr
#comfunc global IPolicyQualifier_get_Qualifier     9 var
#comfunc global IPolicyQualifier_get_Type          10 var
#comfunc global IPolicyQualifier_get_RawData       11 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IPolicyQualifier "{728AB31C-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global IPolicyQualifier IID_IPolicyQualifier "{}"
#comfunc global IPolicyQualifier_InitializeEncode  7 wstr,int
#comfunc global IPolicyQualifier_get_ObjectId      8 sptr
#comfunc global IPolicyQualifier_get_Qualifier     9 sptr
#comfunc global IPolicyQualifier_get_Type          10 sptr
#comfunc global IPolicyQualifier_get_RawData       11 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。