Fungsi SetFileCompletionNotificationModes (winbase.h)

Artikel
03/13/2024

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

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

Share via