Metode IFileOperation::SetOperationFlags (shobjidl_core.h)
Mengatur parameter untuk operasi saat ini.
Sintaks
HRESULT SetOperationFlags(
[in] DWORD dwOperationFlags
);
Parameter
[in] dwOperationFlags
Jenis: DWORD
Bendera yang mengontrol operasi file. Anggota ini bisa menjadi kombinasi dari bendera berikut. Bendera FOF didefinisikan dalam bendera Shellapi.h dan FOFX ditentukan dalam Shobjidl.h.
FOF_ALLOWUNDO (0x0040)
Pertahankan informasi urungkan, jika memungkinkan.
Sebelum Windows Vista, operasi hanya dapat dibatalkan dari proses yang sama yang melakukan operasi asli.
Di Windows Vista dan sistem yang lebih baru, cakupan pembongkaran adalah sesi pengguna. Setiap proses yang berjalan dalam sesi pengguna dapat membatalkan operasi lain. Status batalkan diadakan dalam proses Explorer.exe, dan selama proses tersebut berjalan, ia dapat mengoordinasikan fungsi batalkan.
Jika parameter file sumber tidak berisi jalur dan nama file yang sepenuhnya memenuhi syarat, bendera ini diabaikan.
FOF_FILESONLY (0x0080)
Lakukan operasi hanya pada file (bukan pada folder) jika nama file kartubebas (.) ditentukan.
FOF_NOCONFIRMATION (0x0010)
Tanggapi dengan Ya untuk Semua untuk kotak dialog apa pun yang ditampilkan.
FOF_NOCONFIRMMKDIR (0x0200)
Jangan mengonfirmasi pembuatan folder baru jika operasi memerlukannya untuk dibuat.
FOF_NO_CONNECTED_ELEMENTS (0x2000)
Jangan pindahkan item yang tersambung sebagai grup. Hanya pindahkan file yang ditentukan.
FOF_NOCOPYSECURITYATTRIBS (0x0800)
Jangan salin atribut keamanan item.
FOF_NOERRORUI (0x0400)
Jangan tampilkan pesan kepada pengguna jika terjadi kesalahan. Jika bendera ini diatur tanpa FOFX_EARLYFAILURE, kesalahan apa pun diperlakukan seolah-olah pengguna telah memilih Abaikan atau Lanjutkan dalam kotak dialog. Tindakan ini menghentikan tindakan saat ini, menetapkan bendera untuk menunjukkan bahwa tindakan dibatalkan, dan melanjutkan operasi lainnya.
FOF_NORECURSION (0x1000)
Hanya beroperasi di folder lokal. Jangan beroperasi secara rekursif ke subdirektori.
FOF_RENAMEONCOLLISION (0x0008)
Berikan item yang sedang dioperasikan pada nama baru dalam operasi pindah, salin, atau ganti nama jika item dengan nama target sudah ada.
FOF_SILENT (0x0004)
Jangan tampilkan kotak dialog kemajuan.
FOF_WANTNUKEWARNING (0x4000)
Kirim peringatan jika file atau folder sedang dihancurkan selama operasi penghapusan daripada didaur ulang. Bendera ini sebagian mengambil alih FOF_NOCONFIRMATION.
FOFX_ADDUNDORECORD (0x20000000)
Diperkenalkan dalam Windows 8. Operasi file dipanggil pengguna dan harus ditempatkan pada tumpukan batalkan. Bendera ini lebih disukai untuk FOF_ALLOWUNDO.
FOFX_NOSKIPJUNCTIONS (0x00010000)
Masuk ke persimpangan namespace Shell. Secara default, persimpangan tidak dimasukkan. Untuk informasi selengkapnya tentang persimpangan, lihat Menentukan Lokasi Ekstensi Namespace.
FOFX_PREFERHARDLINK (0x00020000)
Jika memungkinkan, buat tautan keras daripada instans baru file di tujuan.
FOFX_SHOWELEVATIONPROMPT (0x00040000)
Jika operasi memerlukan hak yang ditingkatkan dan bendera FOF_NOERRORUI diatur untuk menonaktifkan UI kesalahan, tampilkan perintah UI UAC.
FOFX_EARLYFAILURE (0x00100000)
Jika FOFX_EARLYFAILURE diatur bersama dengan FOF_NOERRORUI, seluruh set operasi dihentikan setelah mengalami kesalahan dalam operasi apa pun. Bendera ini hanya valid ketika FOF_NOERRORUI diatur.
FOFX_PRESERVEFILEEXTENSIONS (0x00200000)
Ganti nama tabrakan sewaktu-waktu untuk mempertahankan ekstensi nama file. Bendera ini hanya valid ketika FOF_RENAMEONCOLLISION juga diatur.
FOFX_KEEPNEWERFILE (0x00400000)
Pertahankan file atau folder yang lebih baru, berdasarkan properti Tanggal Diubah, jika tabrakan terjadi. Ini dilakukan secara otomatis tanpa UI perintah yang disajikan kepada pengguna.
FOFX_NOCOPYHOOKS (0x00800000)
Jangan gunakan kait salinan.
FOFX_NOMINIMIZEBOX (0x01000000)
Jangan izinkan dialog kemajuan diminimalkan.
FOFX_MOVEACLSACROSSVOLUMES (0x02000000)
Salin atribut keamanan item sumber ke item tujuan saat melakukan operasi pemindahan lintas volume. Tanpa bendera ini, item tujuan menerima atribut keamanan folder barunya.
FOFX_DONTDISPLAYSOURCEPATH (0x04000000)
Jangan tampilkan jalur item sumber dalam dialog kemajuan.
FOFX_DONTDISPLAYDESTPATH (0x08000000)
Jangan tampilkan jalur item tujuan dalam dialog kemajuan.
FOFX_RECYCLEONDELETE (0x00080000)
Diperkenalkan dalam Windows 8. Saat file dihapus, kirimkan ke Keranjang Sampah daripada menghapusnya secara permanen.
FOFX_REQUIREELEVATION (0x10000000)
Diperkenalkan di Windows Vista SP1. Pengguna mengharapkan persyaratan untuk elevasi hak, jadi jangan tampilkan kotak dialog yang meminta konfirmasi elevasi.
FOFX_COPYASDOWNLOAD (0x40000000)
Diperkenalkan di Windows 7. Tampilkan Pengunduhan alih-alih Menyalin pesan dalam dialog kemajuan.
FOFX_DONTDISPLAYLOCATIONS (0x80000000)
Diperkenalkan di Windows 7. Jangan tampilkan baris lokasi dalam dialog kemajuan.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Atur bendera ini sebelum Anda memanggil IFileOperation::P erformOperations untuk menentukan parameter untuk operasi apa pun yang sedang dilakukan, seperti menyalin, menghapus, atau mengganti nama.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista, Windows 7 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shobjidl_core.h (termasuk Shobjidl.h) |