ホーム › Security.Cryptography.Certificates › IX509ExtensionSubjectKeyIdentifier

IX509ExtensionSubjectKeyIdentifier

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

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

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

公式ドキュメント

SubjectKeyIdentifier 拡張を指定できるようにします。

メソッド 3

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

vtbl 12 HRESULT InitializeEncode(EncodingType Encoding, LPWSTR strKeyIdentifier)

キー識別子を含むバイト配列から拡張を初期化します。

Encoding	EncodingType	in	strKeyIdentifier パラメーターに適用される Unicode エンコードの種類を指定する EncodingType 列挙値です。
strKeyIdentifier	LPWSTR	in	キー識別子を含む BSTR 変数です。

戻り値

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

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

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

解説(Remarks)

通常、入力値は、証明機関 (CA) の署名証明書に含まれる公開キーの SHA-1 ハッシュにする必要があります。このメソッドは、値を XCN_OID_SUBJECT_KEY_IDENTIFIER (2.5.29.14) オブジェクト識別子 (OID) に関連付け、Distinguished Encoding Rules (DER) を使用してエンコードします。

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

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

Critical プロパティは、拡張がクリティカルかどうかを示します。このプロパティは指定することもできます。
ObjectId プロパティは OID を取得します。
AuthorityKeyIdentifier プロパティは生データを取得します。

vtbl 13 HRESULT InitializeDecode(EncodingType Encoding, LPWSTR strEncodedData)

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

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

戻り値

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

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

解説(Remarks)

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

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

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

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

vtbl 14 HRESULT get_SubjectKeyIdentifier(EncodingType Encoding, LPWSTR* pValue)

キー識別子を含むバイト配列を取得します。

Encoding	EncodingType	in	出力する pValue の希望するエンコード形式を指定する EncodingType 値である。
pValue	LPWSTR*	out	指定エンコード形式によるサブジェクトキー識別子の文字列を受け取る出力先である。

解説(Remarks)

IX509ExtensionSubjectKeyIdentifier オブジェクトを初期化するには、InitializeDecode メソッドまたは InitializeEncode メソッドを呼び出します。また、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_IX509ExtensionSubjectKeyIdentifier "{728AB317-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global IX509ExtensionSubjectKeyIdentifier IID_IX509ExtensionSubjectKeyIdentifier "{}"
#comfunc global IX509ExtensionSubjectKeyIdentifier_InitializeEncode          12 int,wstr
#comfunc global IX509ExtensionSubjectKeyIdentifier_InitializeDecode          13 int,wstr
#comfunc global IX509ExtensionSubjectKeyIdentifier_get_SubjectKeyIdentifier  14 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IX509ExtensionSubjectKeyIdentifier "{728AB317-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global IX509ExtensionSubjectKeyIdentifier IID_IX509ExtensionSubjectKeyIdentifier "{}"
#comfunc global IX509ExtensionSubjectKeyIdentifier_InitializeEncode          12 int,wstr
#comfunc global IX509ExtensionSubjectKeyIdentifier_InitializeDecode          13 int,wstr
#comfunc global IX509ExtensionSubjectKeyIdentifier_get_SubjectKeyIdentifier  14 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。