IFileOperation::SetOperationFlags 方法 (shobjidl_core.h)
設定目前作業的參數。
語法
HRESULT SetOperationFlags(
[in] DWORD dwOperationFlags
);
參數
[in] dwOperationFlags
類型: DWORD
控制檔案作業的旗標。 這個成員可以是下列旗標的組合。 FOF 旗標是在Shellapi.h 中定義,FOFX 旗標是在 Shobjidl.h 中定義。
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)
如果作業需要提高的許可權,且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) |