ホーム › System.Mmc › IEnumTASK

IEnumTASK

COM

📘 Microsoft Learn (日本語) · English

IID338698b1-5a02-11d1-9fec-00600832db4a継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IEnumTASK インターフェイスは MMC 1.1 で導入されました。

メソッド 4

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

vtbl 3 HRESULT Next(DWORD celt, MMC_TASK* rgelt, DWORD* pceltFetched)

IEnumTASK::Next メソッドは、スナップインのタスク一覧から次のタスクを MMC が取得できるようにします。

celt	DWORD	in	提供するタスクの数を指定する値です。MMC は常に一度に 1 つずつタスクを列挙します。そのため、celt は常に 1 です。
rgelt	MMC_TASK*	out	タスクパッドに追加するタスクを表すためにスナップインが値を設定する MMC_TASK 構造体へのポインターです。この構造体のメモリは呼び出し元 (MMC) が割り当てる点に注意してください。
pceltFetched	DWORD*	out	返されたタスクの数を指定する値へのポインターです。スナップインが 1 つ以上のタスクを正常に返した場合は、正常に返したタスクの数をこの値に設定します。MMC は常に一度に 1 つずつタスクを要求する (celt は常に 1) ため、タスクが正常に返された場合、pceltFetched は 1 に設定してください。スナップインの一覧にこれ以上タスクがない場合、またはスナップインが MMC_TASK 構造体の値の設定に失敗した場合は、この値を 0 に設定してください。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

解説(Remarks)

MMC は、スナップインがタスクパッドに追加する必要のあるタスクの一覧を列挙するためにこのメソッドを呼び出します。MMC は、スナップインがタスクパッドに追加するタスクがこれ以上ないことを示す S_FALSE が返されるまで、このメソッドを呼び出します。

vtbl 4 HRESULT Skip(DWORD celt)

IEnumTASK::Skip メソッドは、スナップインのタスク一覧内で指定された数のタスクをスキップします。MMC はこのメソッドを使用しません。完全性のために含める必要があります。

celt

DWORD

一覧内の現在のタスクを基準としてスキップするタスクの数を指定する値です。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

vtbl 5 HRESULT Reset()

IEnumTASK::Reset メソッドは、列挙をスナップインのタスク一覧の先頭にリセットできるようにします。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

vtbl 6 HRESULT Clone(IEnumTASK** ppenum)

IEnumTASK::Clone メソッドは、この IEnumTASK オブジェクトと同じ状態を持つ新しい IEnumTASK オブジェクトを作成します。MMC はこのメソッドを使用しません。完全性のために含める必要があります。

ppenum

IEnumTASK**

out

複製された IEnumTASK オブジェクトの IEnumTASK インターフェイスポインターのアドレスへのポインターです。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

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