ホーム › System.Mmc › Property

Property

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

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

IID4600c3a5-e301-41d8-b6d0-ef2e4212e0ca継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

Windows Portable Devices は、以下のプロパティ属性をサポートします。

解説(Remarks)

Windows Portable Devices は、以下のプロパティ属性をサポートします。これらの属性は、以下のメソッドによって返されます:

属性	VarType	説明
WPD_PROPERTY_ATTRIBUTE_CAN_DELETE	VT_BOOL	クライアントがプロパティを削除できるかどうかを指定するブール値です。プロパティを削除するには、その値を VT_EMPTY に設定します。
WPD_PROPERTY_ATTRIBUTE_CAN_READ	VT_BOOL	クライアントがプロパティを読み取れるかどうかを指定するブール値です。
WPD_PROPERTY_ATTRIBUTE_CAN_WRITE	VT_BOOL	クライアントがプロパティを変更できるかどうかを指定するブール値です。
WPD_PROPERTY_ATTRIBUTE_DEFAULT_VALUE	VT_XXXX	プロパティの既定値を指定する、デバイスによって定義される値です。これは書き込み可能なプロパティにのみ適用されます。
WPD_PROPERTY_ATTRIBUTE_ENUMERATION_ELEMENTS	VT_UNKNOWN	WPD_PROPERTY_ATTRIBUTE_FORM 属性が WPD_PROPERTY_ATTRIBUTE_FORM_ENUMERATION であるプロパティの値のコレクションを含む IPortableDevicePropVariantCollection インターフェイスです。データ型は、クエリするプロパティによって異なります。
WPD_PROPERTY_ATTRIBUTE_FAST_PROPERTY	VT_BOOL	True の場合、このプロパティは高速プロパティグループに属します。これらは、デバイスから素早く取得できるプロパティです。
WPD_PROPERTY_ATTRIBUTE_FORM	VT_UI4	このプロパティで許可される有効な値の形式を指定する WpdAttributeForm 列挙値です。
WPD_PROPERTY_ATTRIBUTE_NAME	VT_LPWSTR	プロパティのスクリプトフレンドリーな名前を指定する文字列です。有効な文字は英数字 [a-zA-Z0-9] と '_' です。
WPD_PROPERTY_ATTRIBUTE_RANGE_MAX	VT_XXXX	WPD_PROPERTY_ATTRIBUTE_FORM 属性が WPD_PROPERTY_ATTRIBUTE_FORM_RANGE であるプロパティの最大値です。データ型には任意の数値型を指定できます。
WPD_PROPERTY_ATTRIBUTE_RANGE_MIN	VT_XXXX	WPD_PROPERTY_ATTRIBUTE_FORM 属性が WPD_PROPERTY_ATTRIBUTE_FORM_RANGE であるプロパティの最小値です。データ型には任意の数値型を指定できます。
WPD_PROPERTY_ATTRIBUTE_RANGE_STEP	VT_XXXX	WPD_PROPERTY_ATTRIBUTE_FORM 属性が WPD_PROPERTY_ATTRIBUTE_FORM_RANGE であるプロパティのステップ値です。ステップは、範囲プロパティがどれだけ変化しなければならないかを指定します。たとえば、最小値 10、最大値 20、ステップ 5 のプロパティは、次の値を取ることができます: 10、15、20。データ型には任意の数値型を指定できます。
WPD_PROPERTY_ATTRIBUTE_REGULAR_EXPRESSION	VT_LPWSTR	形式が WPD_PROPERTY_ATTRIBUTE_FORM_REGULAR_EXPRESSION であるプロパティの許容値を指定する正規表現文字列です。
WPD_PROPERTY_ATTRIBUTE_VARTYPE	VT_UI4	プロパティの VARTYPE を指定する整数です(例: VT_BOOL)。
WPD_PROPERTY_ATTRIBUTE_MAX_SIZE	VT_UI8	このプロパティの値の最大サイズをバイト単位で指定する値です。

メソッド 3

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

vtbl 7 HRESULT get_Value(VARIANT* Value)

Value

VARIANT*

out

プロパティの値を受け取る VARIANT へのポインタである。

vtbl 8 HRESULT put_Value(VARIANT Value)

Value

VARIANT

プロパティに設定する値を格納した VARIANT を指定する。

vtbl 9 HRESULT get_Name(LPWSTR* Name)

Name

LPWSTR*

out

プロパティの名前を受け取る文字列へのポインタである。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_Property "{4600C3A5-E301-41D8-B6D0-EF2E4212E0CA}"
#usecom global Property IID_Property "{}"
#comfunc global Property_get_Value  7 var
#comfunc global Property_put_Value  8 int
#comfunc global Property_get_Name   9 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_Property "{4600C3A5-E301-41D8-B6D0-EF2E4212E0CA}"
#usecom global Property IID_Property "{}"
#comfunc global Property_get_Value  7 sptr
#comfunc global Property_put_Value  8 int
#comfunc global Property_get_Name   9 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。