Win32 API 日本語リファレンス
ホーム › Devices.PortableDevices › IPortableDeviceKeyCollection

IPortableDeviceKeyCollection

COM
📘 Microsoft Learn (日本語) · English
IIDdada2357-e0ad-492e-98db-dd61c53ba353継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IPortableDeviceKeyCollection インターフェイスは、PROPERTYKEY 値のコレクションを保持します。このインターフェイスはメソッドから取得できます。新しいオブジェクトが必要な場合は、CLSID_PortableDeviceKeyCollection を指定して CoCreate を呼び出します。

解説(Remarks)

IPortableDeviceKeyCollection インターフェイスは、PROPERTYKEY 値のコレクションを保持します。このインターフェイスはメソッドから取得できます。新しいオブジェクトが必要な場合は、CLSID_PortableDeviceKeyCollection を指定して CoCreate を呼び出します。

メソッド 5

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetCount(DWORD* pcElems)

このコレクション内のキーの数を取得します。

pcElemsDWORD*inコレクション内のキー総数を受け取る出力先。
vtbl 4 HRESULT GetAt(DWORD dwIndex, PROPERTYKEY* pKey)

インデックスを指定して、コレクションから PROPERTYKEY を取得します。

dwIndexDWORDin取得するキーの0始まりのインデックス。
pKeyPROPERTYKEY*in指定位置のキー(PROPERTYKEY)を受け取る出力先。
vtbl 5 HRESULT Add(PROPERTYKEY* Key)

コレクションにプロパティキーを追加します。

KeyPROPERTYKEY*inコレクションに追加するPROPERTYKEYへのポインタ。
vtbl 6 HRESULT Clear()

コレクションからすべての項目を削除します。

vtbl 7 HRESULT RemoveAt(DWORD dwIndex)

指定されたインデックスが示す位置に格納されている要素を削除します。

dwIndexDWORDin削除するキーの0始まりのインデックス。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IPortableDeviceKeyCollection "{DADA2357-E0AD-492E-98DB-DD61C53BA353}"
#usecom global IPortableDeviceKeyCollection IID_IPortableDeviceKeyCollection "{DE2D022D-2480-43BE-97F0-D1FA2CF98F4F}"
#comfunc global IPortableDeviceKeyCollection_GetCount  3 var
#comfunc global IPortableDeviceKeyCollection_GetAt     4 int,var
#comfunc global IPortableDeviceKeyCollection_Add       5 var
#comfunc global IPortableDeviceKeyCollection_Clear     6
#comfunc global IPortableDeviceKeyCollection_RemoveAt  7 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。