ホーム › System.Wmi › IWbemHiPerfEnum

IWbemHiPerfEnum

COM

📘 Microsoft Learn (日本語) · English

IID2705c288-79ae-11d2-b348-00105a1f8177継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

リフレッシャー操作で使用され、インスタンスオブジェクトの列挙に高速にアクセスする手段を提供します。

メソッド 4

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

vtbl 3 HRESULT AddObjects(INT lFlags, DWORD uNumObjects, INT* apIds, IWbemObjectAccess** apObj)

IWbemHiPerfEnum::AddObjects メソッドは、指定されたインスタンスオブジェクトを列挙子に追加します。

lFlags	INT	in	予約されています。このパラメーターは 0 でなければなりません。
uNumObjects	DWORD	in	オブジェクト配列内の項目数、およびパラメーター内の識別子の数です。
apIds	INT*	in	オブジェクト配列内の各オブジェクトに対する一意の識別子を格納する整数配列へのポインターです。
apObj	IWbemObjectAccess**	in	列挙子に追加するインスタンスオブジェクトの配列へのポインターです。

戻り値

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。次の一覧に、HRESULT に格納される値を示します。

解説(Remarks)

識別子が既に存在する場合は、WBEM_E_FAILED が返されます。リフレッシャー識別子は、後でオブジェクトを削除するために使用できます。

vtbl 4 HRESULT RemoveObjects(INT lFlags, DWORD uNumObjects, INT* apIds)

IWbemHiPerfEnum::RemoveObjects メソッドは、リフレッシャー識別子で指定されたオブジェクトをリフレッシャーから削除します。

lFlags	INT	in	予約されています。このパラメーターは 0 (ゼロ) でなければなりません。
uNumObjects	DWORD	in	削除するオブジェクトの数です。
apIds	INT*	in	削除するオブジェクトのリフレッシャー識別子を格納する整数配列へのポインターです。

戻り値

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。次の一覧に、HRESULT に格納される値を示します。

vtbl 5 HRESULT GetObjects(INT lFlags, DWORD uNumObjects, IWbemObjectAccess** apObj, DWORD* puReturned)

IWbemHiPerfEnum::GetObjects メソッドは、現在列挙子内に存在するオブジェクトを取得します。

lFlags	INT	in	フラグを格納する整数です。
uNumObjects	DWORD	in	apObj パラメーターでこのメソッドに渡す配列のサイズです。
apObj	IWbemObjectAccess**	out	返されるオブジェクトを格納する IWbemObjectAccess オブジェクトの配列への参照を保持するポインターです。この配列は、列挙子内のすべてのオブジェクトを格納できる大きさでなければなりません。
puReturned	DWORD*	out	配列に格納されたオブジェクトの数を返すために使用される ULONG へのポインターです。

戻り値

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。次の一覧に、HRESULT に格納される値を示します。

解説(Remarks)

配列はすべてのオブジェクトを格納できる大きさでなければなりません。そうでない場合、puReturned には返されたオブジェクトの数が設定され、WBEM_E_BUFFER_TOO_SMALL が返されます。

vtbl 6 HRESULT RemoveAll(INT lFlags)

IWbemHiPerfEnum::RemoveAll メソッドは、列挙子からすべてのオブジェクトを削除します。

lFlags

INT

予約されています。このパラメーターは 0 (ゼロ) でなければなりません。

戻り値

成功した場合、このメソッドは WBEM_S_NO_ERROR を返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IWbemHiPerfEnum "{2705C288-79AE-11D2-B348-00105A1F8177}"
#usecom global IWbemHiPerfEnum IID_IWbemHiPerfEnum "{}"
#comfunc global IWbemHiPerfEnum_AddObjects     3 int,int,var,sptr
#comfunc global IWbemHiPerfEnum_RemoveObjects  4 int,int,var
#comfunc global IWbemHiPerfEnum_GetObjects     5 int,int,sptr,var
#comfunc global IWbemHiPerfEnum_RemoveAll      6 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IWbemHiPerfEnum "{2705C288-79AE-11D2-B348-00105A1F8177}"
#usecom global IWbemHiPerfEnum IID_IWbemHiPerfEnum "{}"
#comfunc global IWbemHiPerfEnum_AddObjects     3 int,int,sptr,sptr
#comfunc global IWbemHiPerfEnum_RemoveObjects  4 int,int,sptr
#comfunc global IWbemHiPerfEnum_GetObjects     5 int,int,sptr,sptr
#comfunc global IWbemHiPerfEnum_RemoveAll      6 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。