Fungsi SetFileCompletionNotificationModes (winbase.h)

Mengatur mode pemberitahuan untuk handel file, memungkinkan Anda menentukan cara kerja pemberitahuan penyelesaian untuk file yang ditentukan.

Sintaks

BOOL SetFileCompletionNotificationModes(
  [in] HANDLE FileHandle,
  [in] UCHAR  Flags
);

Parameter

[in] FileHandle

Handel ke file.

[in] Flags

Mode yang akan diatur. Satu atau beberapa mode dapat diatur secara bersamaan; namun, setelah mode diatur untuk handel file, mode tidak dapat dihapus.

Nilai Makna
FILE_SKIP_COMPLETION_PORT_ON_SUCCESS
0x1
 Jika tiga kondisi berikut ini benar, Manajer I/O tidak mengantrekan entri penyelesaian ke port, ketika biasanya akan melakukannya. Kondisinya adalah:
  • Port penyelesaian dikaitkan dengan handel file.
  • File dibuka untuk I/O asinkron.
  • Permintaan segera mengembalikan keberhasilan tanpa mengembalikan ERROR_PENDING.

Ketika parameter FileHandle adalah soket, mode ini hanya kompatibel dengan Penyedia Layanan Berlapis (LSP) yang mengembalikan handel Installable File Systems (IFS). Untuk mendeteksi apakah LSP non-IFS diinstal, gunakan fungsi WSAEnumProtocols dan periksa anggota dwServiceFlag1 di setiap struktur WSAPROTOCOL_INFO yang dikembalikan. Jika bit XP1_IFS_HANDLES (0x20000) dibersihkan maka LSP yang ditentukan bukan LSP IFS. Vendor yang memiliki LSP non-IFS didorong untuk bermigrasi ke Windows Filtering Platform (WFP).
FILE_SKIP_SET_EVENT_ON_HANDLE
0x2
 Manajer I/O tidak mengatur peristiwa untuk objek file jika permintaan kembali dengan kode keberhasilan, atau kesalahan yang dikembalikan ERROR_PENDING dan fungsi yang disebut bukan fungsi sinkron.

Jika peristiwa eksplisit disediakan untuk permintaan, itu masih disinyalir.

Nilai kembali

Mengembalikan bukan nol jika berhasil atau nol sebaliknya.

Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan makro _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.

Teknologi Didukung
Protokol Server Message Block (SMB) 3.0 Ya
SMB 3.0 Transparent Failover (TFO) Ya
SMB 3.0 dengan Scale-out File Shares (SO) Ya
Sistem File Volume Bersama Kluster (CsvFS) Ya
Sistem File Tangguh (ReFS) Ya

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header winbase.h (termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

Fungsi Manajemen File

  • Last updated on