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

IX509AttributeOSVersion

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

公式ドキュメント

証明書要求が生成されたクライアントオペレーティングシステムに関するバージョン情報を格納する属性を表します。

メソッド 3

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

vtbl 10 HRESULT InitializeEncode(LPWSTR strOSVersion)

オペレーティングシステムのバージョン情報から属性を初期化します。

strOSVersionLPWSTRinバージョン情報を格納する BSTR 変数。文字列の形式は major.minor.build.platform です。このパラメーターは省略可能です。文字列を指定しない場合、このメソッドは GetVersionEx 関数を呼び出します。

戻り値

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

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

解説(Remarks)

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

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

vtbl 11 HRESULT InitializeDecode(EncodingType Encoding, LPWSTR strEncodedData)

オペレーティングシステムのバージョン情報を格納する DER (Distinguished Encoding Rules) でエンコードされたバイト配列からオブジェクトを初期化します。

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

戻り値

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

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

解説(Remarks)

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

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

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

vtbl 12 HRESULT get_OSVersion(LPWSTR* pValue)

クライアントオペレーティングシステムのバージョン情報を取得します。

pValueLPWSTR*outオペレーティング システムのバージョン文字列を受け取る出力先である。

解説(Remarks)

OSVersion プロパティを初期化するには、InitializeEncode メソッドまたは 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_IX509AttributeOSVersion "{728AB32A-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global IX509AttributeOSVersion IID_IX509AttributeOSVersion "{}"
#comfunc global IX509AttributeOSVersion_InitializeEncode  10 wstr
#comfunc global IX509AttributeOSVersion_InitializeDecode  11 int,wstr
#comfunc global IX509AttributeOSVersion_get_OSVersion     12 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。