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

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

現在の列挙体と同じ列挙状態を含む新しい列挙オブジェクトを作成します。

新しいオブジェクトは列挙シーケンス内の同じ場所を指しているため、クライアントは Clone メソッドを使用して列挙シーケンス内の特定のポイントを記録し、後でそのポイントに戻ることができます。

構文

HRESULT Clone(
  [out] IEnumWorkItems **ppEnumWorkItems
);

パラメーター

[out] ppEnumWorkItems

新しい IEnumWorkItems インターフェイスへのポインターへのポインター。 このポインターは、新しく作成された列挙体を指します。 メソッドが失敗した場合、このパラメーターは未定義です。

戻り値

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

リターン コード 説明
S_OK
操作に成功しました。
E_INVALIDARG
引数が無効です。
E_OUTOFMEMORY
メモリが不足しています。
E_UNEXPECTED
エラーが発生しました。

解説

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::Next

IEnumWorkItems::Reset

IEnumWorkItems::Skip