IEnumTASK::Next メソッド (mmc.h)
IEnumTASK::Next メソッドを使用すると、MMC はスナップインのタスクの一覧で次のタスクを取得できます。
構文
HRESULT Next(
[in] ULONG celt,
[out] MMC_TASK *rgelt,
[out] ULONG *pceltFetched
);
パラメーター
[in] celt
指定するタスクの数を示す 値。 MMC は常に一度に 1 つずつタスクを列挙します。したがって、celt は常に 1 です。
[out] rgelt
タスクパッドに追加するタスクを表すためにスナップインが入力する MMC_TASK 構造体へのポインター。 呼び出し元 (MMC) が構造体のメモリを割り当てることに注意してください。
[out] pceltFetched
返されるタスクの数を指定する値へのポインター。 スナップインから 1 つ以上のタスクが正常に返された場合は、値を正常に返されたタスクの数に設定します。 MMC は常に一度に 1 つのタスクを要求するため (celt は常に 1)、タスクが正常に返された場合は、pceltFetched を 1 に設定する必要があります。 スナップインの一覧にタスクが追加されていない場合、またはスナップインがMMC_TASK構造体の入力に失敗した場合は、値を 0 に設定します。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
解説
MMC は、このメソッドを呼び出して、スナップインがタスクパッドに追加する必要があるタスクの一覧を列挙します。 MMC は、S_FALSEを返すまでこのメソッドを呼び出して、スナップインがタスクパッドに追加するタスクがないことを示します。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | mmc.h |