Win32 API 日本語リファレンス
ホーム › Security.Cryptography.Certificates › IX509AttributeArchiveKeyHash

IX509AttributeArchiveKeyHash

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID728ab328-217d-11da-b2a4-000e7bbb2b09継承元IX509Attribute呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl10

公式ドキュメント

証明機関 (CA) によってアーカイブされる暗号化された秘密キーの SHA-1 ハッシュを格納する属性を表します。

メソッド 3

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

vtbl 10 HRESULT InitializeEncodeFromEncryptedKeyBlob(EncodingType Encoding, LPWSTR strEncryptedKeyBlob)

暗号化された秘密キーから属性を初期化します。

EncodingEncodingTypeinキーを格納する入力文字列に適用される Unicode エンコードの種類を指定する EncodingType 列挙値。
strEncryptedKeyBlobLPWSTRin暗号化されたキーを格納する BSTR 変数。

戻り値

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

関数が失敗した場合、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。

解説(Remarks)

この属性の オブジェクト識別子 (OID) は XCN_OID_ENCRYPTED_KEY_HASH (1.3.6.1.4.1.311.21.21) です。詳細については、CERTENROLL_OBJECTID を参照してください。

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

vtbl 11 HRESULT InitializeDecode(EncodingType Encoding, LPWSTR strEncodedData)

暗号化された秘密キーの SHA-1 ハッシュを格納する Distinguished Encoding Rules (DER) エンコードされたバイト配列からオブジェクトを初期化します。

EncodingEncodingTypeinハッシュ値を格納する入力文字列に適用される Unicode エンコードの種類を指定する EncodingType 列挙値。
strEncodedDataLPWSTRinDER エンコードされた属性を格納する BSTR 変数。

戻り値

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

関数が失敗した場合、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。

解説(Remarks)

この属性の オブジェクト識別子 (OID) は XCN_OID_ENCRYPTED_KEY_HASH (1.3.6.1.4.1.311.21.21) です。詳細については、CERTENROLL_OBJECTID を参照してください。

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

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

vtbl 12 HRESULT get_EncryptedKeyHashBlob(EncodingType Encoding, LPWSTR* pValue)

暗号化された秘密キーのハッシュを格納する文字列を取得します。

EncodingEncodingTypein出力する pValue の希望するエンコード形式を指定する EncodingType 値である。
pValueLPWSTR*out暗号化キー BLOB のハッシュを指定エンコード形式で受け取る出力先である。

解説(Remarks)

EncryptedKeyHashBlob プロパティを初期化するには、InitializeEncodeFromEncryptedKeyBlob メソッドまたは InitializeDecode メソッドを呼び出します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IX509AttributeArchiveKeyHash "{728AB328-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global IX509AttributeArchiveKeyHash IID_IX509AttributeArchiveKeyHash "{}"
#comfunc global IX509AttributeArchiveKeyHash_InitializeEncodeFromEncryptedKeyBlob  10 int,wstr
#comfunc global IX509AttributeArchiveKeyHash_InitializeDecode                      11 int,wstr
#comfunc global IX509AttributeArchiveKeyHash_get_EncryptedKeyHashBlob              12 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。