IFileOperation::SetOperationFlags メソッド (shobjidl_core.h)

[アーティクル]
08/26/2023

現在の操作のパラメーターを設定します。

構文

HRESULT SetOperationFlags(
  [in] DWORD dwOperationFlags
);

パラメーター

[in] dwOperationFlags

型: DWORD

ファイル操作を制御するフラグ。このメンバーは、次のフラグの組み合わせにすることができます。 FOF フラグは Shellapi.h で定義され、FOFX フラグは Shobjidl.h で定義されます。

メモこのメソッドが呼び出されない場合、操作で使用される既定値は FOF_ALLOWUNDO |FOF_NOCONFIRMMKDIR。

FOF_ALLOWUNDO (0x0040)

可能な場合は、元に戻す情報を保持します。

Windows Vista より前では、元の操作を実行したのと同じプロセスからのみ操作を元に戻すことができます。

Windows Vista 以降のシステムでは、元に戻すのスコープはユーザーセッションです。ユーザーセッションで実行されているプロセスは、別の操作を元に戻すことができます。元に戻す状態は Explorer.exe プロセスに保持され、そのプロセスが実行されている限り、元に戻す機能を調整できます。

ソースファイルパラメーターに完全修飾パスとファイル名が含まれていない場合、このフラグは無視されます。

FOF_FILESONLY (0x0080)

ワイルドカードファイル名 (.) が指定されている場合は、(フォルダーではなく) ファイルに対してのみ操作を実行します。

FOF_NOCONFIRMATION (0x0010)

表示されているダイアログボックスに対 して、[すべて] に [はい ] と応答します。

FOF_NOCONFIRMMKDIR (0x0200)

操作で作成する必要がある場合は、新しいフォルダーの作成を確認しないでください。

FOF_NO_CONNECTED_ELEMENTS (0x2000)

接続されている項目をグループとして移動しないでください。指定したファイルのみを移動します。

FOF_NOCOPYSECURITYATTRIBS (0x0800)

アイテムのセキュリティ属性をコピーしないでください。

FOF_NOERRORUI (0x0400)

エラーが発生した場合は、ユーザーにメッセージを表示しないでください。このフラグをFOFX_EARLYFAILUREせずに設定すると、ユーザーがダイアログボックスで [無視 ] または [続行 ] を選択したかのようにエラーが処理されます。現在のアクションを停止し、アクションが中止されたことを示すフラグを設定し、操作の残りの部分を続行します。

FOF_NORECURSION (0x1000)

ローカルフォルダーでのみ動作します。サブディレクトリに再帰的に操作しないでください。

FOF_RENAMEONCOLLISION (0x0008)

ターゲット名を持つ項目が既に存在する場合は、移動、コピー、または名前変更操作で、新しい名前で操作されている項目を指定します。

FOF_SILENT (0x0004)

進行状況ダイアログボックスを表示しません。

FOF_WANTNUKEWARNING (0x4000)

ファイルまたはフォルダーがリサイクルされずに削除操作中に破棄されている場合は、警告を送信します。このフラグは、 FOF_NOCONFIRMATIONを部分的にオーバーライドします。

FOFX_ADDUNDORECORD (0x20000000)

Windows 8で導入されました。ファイル操作はユーザーが呼び出し、元に戻すスタックに配置する必要があります。このフラグは、FOF_ALLOWUNDOする場合に推奨されます。

FOFX_NOSKIPJUNCTIONS (0x00010000)

シェル名前空間ジャンクションに移動します。既定では、ジャンクションは入力されません。ジャンクションの詳細については、「名前空間拡張機能の場所の指定」を参照してください。

FOFX_PREFERHARDLINK (0x00020000)

可能であれば、変換先のファイルの新しいインスタンスではなく、ハードリンクを作成します。

FOFX_SHOWELEVATIONPROMPT (0x00040000)

操作に昇格された権限が必要で、エラー UI を無効にするために FOF_NOERRORUI フラグが設定されている場合は、UAC UI プロンプトを表示します。

FOFX_EARLYFAILURE (0x00100000)

FOFX_EARLYFAILUREがFOF_NOERRORUIと共に設定されている場合、すべての操作でエラーが発生すると、操作のセット全体が停止します。このフラグは、FOF_NOERRORUIが設定されている場合にのみ有効です。

FOFX_PRESERVEFILEEXTENSIONS (0x00200000)

ファイル名拡張子を保持するように、競合の名前を変更します。このフラグは、FOF_RENAMEONCOLLISIONも設定されている場合にのみ有効です。

FOFX_KEEPNEWERFILE (0x00400000)

競合が発生した場合は、Date Modified プロパティに基づいて、新しいファイルまたはフォルダーを保持します。これは、プロンプト UI がユーザーに表示されない状態で自動的に行われます。

FOFX_NOCOPYHOOKS (0x00800000)

コピーフックは使用しないでください。

FOFX_NOMINIMIZEBOX (0x01000000)

進行状況ダイアログを最小化しないでください。

FOFX_MOVEACLSACROSSVOLUMES (0x02000000)

ボリューム間の移動操作を実行するときに、ソース項目のセキュリティ属性をコピー先の項目にコピーします。このフラグがない場合、宛先アイテムは新しいフォルダーのセキュリティ属性を受け取ります。

FOFX_DONTDISPLAYSOURCEPATH (0x04000000)

進行状況ダイアログにソース項目のパスを表示しないでください。

FOFX_DONTDISPLAYDESTPATH (0x08000000)

進行状況ダイアログに移動先アイテムのパスを表示しないでください。

FOFX_RECYCLEONDELETE (0x00080000)

Windows 8で導入されました。ファイルが削除されたら、ファイルを完全に削除するのではなく、ごみ箱に送信します。

FOFX_REQUIREELEVATION (0x10000000)

Windows Vista SP1 で導入されました。ユーザーは権限昇格の要件を想定しているため、昇格の確認を求めるダイアログボックスを表示しないでください。

FOFX_COPYASDOWNLOAD (0x40000000)

Windows 7 で導入されました。 [進行状況] ダイアログに [コピー] メッセージの代わりに [ダウンロード] を表示します。

FOFX_DONTDISPLAYLOCATIONS (0x80000000)

Windows 7 で導入されました。進行状況ダイアログに場所の行を表示しないでください。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

注釈

IFileOperation::P erformOperations を呼び出す前に、これらのフラグを設定して、コピー、削除、名前変更など、実行される操作のパラメーターを定義します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista、Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)