共用方式為


IFileOperation::SetOperationFlags 方法 (shobjidl_core.h)

設定目前作業的參數。

語法

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_SHOWELEVATIONPROMPT (0x00040000)

如果作業需要提高的許可權,且FOF_NOERRORUI旗標設定為停用錯誤 UI,則仍會顯示 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)