IEnumProgressItems::Clone メソッド (imapi2fs.h)
現在の列挙状態と同じ列挙状態を含む別の列挙子を作成します。
構文
HRESULT Clone(
[out] IEnumProgressItems **ppEnum
);
パラメーター
[out] ppEnum
列挙オブジェクトへのインターフェイス ポインターを受け取ります。 メソッドが失敗した場合、この出力変数の値は未定義になります。 完了したら 、ppEnum を解放する必要があります。
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
| リターン コード | 説明 |
|---|---|
|
ポインターが無効です。
値: 0x80004003 |
|
必要なメモリを割り当てませんでした。
値: 0x8007000E |
解説
このメソッドを使用すると、クライアントは列挙シーケンス内の特定のポイントを記録し、後でそのポイントに戻ることができます。 新しい列挙子は、元の列挙子と同じインターフェイスをサポートします。
要件
| サポートされている最小のクライアント | Windows Vista、SP2 を使用した Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | imapi2fs.h |