次の方法で共有


IEnumWorkItems::Next メソッド (mstask.h)

[[この API は、以降のバージョンのオペレーティング システムまたは製品で変更または使用できない場合があります。 代わりに タスク スケジューラ 2.0 インターフェイス を使用してください。] ]

列挙シーケンス内の次に指定した数のタスクを取得します。

シーケンスに残っているタスクの数が要求された数より少ない場合は、残りのすべての要素が取得されます。

構文

HRESULT Next(
  [in]  ULONG  celt,
  [out] LPWSTR **rgpwszNames,
  [out] ULONG  *pceltFetched
);

パラメーター

[in] celt

取得するタスクの数。

[out] rgpwszNames

列挙シーケンスから返されるタスクのファイル名を含む null で終わる文字列へのポインター (LPWSTR) の配列へのポインター。 これらのファイル名は、 スケジュールされたタスク フォルダー から取得され、".job" 拡張子を持ちます。

rgpwszNames で返された名前を処理した後、まず配列内の各文字列を解放してから、CoTaskMemFree を使用して配列自体を解放する必要があります。

[out] pceltFetched

rgpwszNames で返されるタスクの数へのポインター。 celt パラメーターが 1 の場合、このパラメーターは NULL になる可能性があります。

戻り値

次のいずれかの値を返します。

リターン コード 説明
S_OK
取得されたタスクの数は、要求された数と同じです。
S_FALSE
返される数値は、要求された数より小さくなります。 (したがって、列挙するタスクはこれ以上ありません)。
E_INVALIDARG
パラメーターが無効です。
E_OUTOFMEMORY
メモリが不足しています。

注釈

IEnumWorkItems インターフェイスには、列挙をリセットし、タスクをスキップし、列挙体の現在の状態のコピーを作成するためのメソッドも用意されています。

[次へ] を使用して [スケジュールされたタスク] フォルダー内のタスクを列挙する方法の例については、「タスクの列挙の例」を参照してください。

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mstask.h
Library Mstask.lib
[DLL] Mstask.dll
再頒布可能パッケージ Windows NT 4.0 および Windows 95 のインターネット エクスプローラー 4.0 以降

こちらもご覧ください

IEnumWorkItems

IEnumWorkItems::Clone

IEnumWorkItems::Reset

IEnumWorkItems::Skip