ホーム › Security.Cryptography.Certificates › IX509ExtensionKeyUsage

IX509ExtensionKeyUsage

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

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

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

公式ドキュメント

証明書に含まれる公開キーが実行できる操作に対する制限を定義するために使用できます。

メソッド 3

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

vtbl 12 HRESULT InitializeEncode(X509KeyUsageFlags UsageFlags)

X509KeyUsageFlags 列挙型を使用して拡張を初期化します。

UsageFlags

X509KeyUsageFlags

X509KeyUsageFlags 列挙型の値。次の値のいずれかをビットごとの OR で組み合わせることができます。

値	意味
XCN_CERT_DIGITAL_SIGNATURE_KEY_USAGE	キーは、否認防止、証明書署名、または失効リスト署名以外のサービスをサポートするために Digital Signature Algorithm (DSA) とともに使用されます。DSA は認証によく使用されます。
XCN_CERT_NON_REPUDIATION_KEY_USAGE	キーは、署名エンティティによる操作の虚偽の否認を防止する否認防止サービスの一部として、デジタル署名を検証するために使用されます。
XCN_CERT_KEY_ENCIPHERMENT_KEY_USAGE	キーはキートランスポートに使用されます。つまり、キーは、生成元から実際の使用箇所へ渡されるキーを管理するために使用されます。
XCN_CERT_DATA_ENCIPHERMENT_KEY_USAGE	キーは、暗号化キー以外のユーザーデータを暗号化するために使用されます。
XCN_CERT_KEY_AGREEMENT_KEY_USAGE	キーはキー合意に使用されます。キー合意またはキー交換プロトコルにより、2 者以上が、キーを転送することなく、また事前に共有シークレットを確立することなく、キー値をネゴシエートできます。
XCN_CERT_KEY_CERT_SIGN_KEY_USAGE	キーは証明書署名を検証するために使用されます。この値は、証明機関によって発行された証明書に対してのみ使用できます。
XCN_CERT_OFFLINE_CRL_SIGN_KEY_USAGE	キーは、オフライン証明書失効リスト (CRL) の署名を検証するために使用されます。
XCN_CERT_CRL_SIGN_KEY_USAGE	キーは CRL 署名を検証するために使用されます。
XCN_CERT_ENCIPHER_ONLY_KEY_USAGE	キーは、キー合意の実行中にデータを暗号化するために使用されます。XCN_CERT_KEY_AGREEMENT_KEY_USAGE 値も指定する必要があります。
XCN_CERT_DECIPHER_ONLY_KEY_USAGE	キーは、キー合意の実行中にデータを復号するために使用されます。XCN_CERT_KEY_AGREEMENT_KEY_USAGE 値も指定する必要があります。

戻り値

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

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

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

解説(Remarks)

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

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

Critical プロパティは、拡張がクリティカルかどうかを示します。このプロパティを指定することもできます。
ObjectId プロパティは、拡張のオブジェクト識別子 (OID) を取得します。
KeyUsage プロパティは、公開キーの意図された用途を示す制限 (生の拡張データ) を取得します。

vtbl 13 HRESULT InitializeDecode(EncodingType Encoding, LPWSTR strEncodedData)

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

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

戻り値

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

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

解説(Remarks)

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

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

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

Critical プロパティは、拡張がクリティカルかどうかを示します。このプロパティを指定することもできます。
ObjectId プロパティは、拡張のオブジェクト識別子 (OID) を取得します。
KeyUsage プロパティは、公開キーの意図された用途を示す制限 (生の拡張データ) を取得します。

vtbl 14 HRESULT get_KeyUsage(X509KeyUsageFlags* pValue)

公開キーに課された制限を取得します。

pValue

X509KeyUsageFlags*

out

拡張に格納された鍵用途を受け取る X509KeyUsageFlags へのポインタである。

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