Funzione SetFileCompletionNotificationModes (winbase.h)

Articolo
03/03/2024

Imposta le modalità di notifica per un handle di file, consentendo di specificare il funzionamento delle notifiche di completamento per il file specificato.

Sintassi

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

Parametri

[in] FileHandle

Handle per il file.

[in] Flags

Modalità da impostare. Una o più modalità possono essere impostate contemporaneamente; tuttavia, dopo che una modalità è stata impostata per un handle di file, non può essere rimossa.

Valore	Significato
FILE_SKIP_COMPLETION_PORT_ON_SUCCESS 0x1	Se le tre condizioni seguenti sono vere, gestione I/O non accoda una voce di completamento alla porta, quando si intende eseguire normalmente. Le condizioni sono: Una porta di completamento è associata all'handle di file. Il file viene aperto per I/O asincrono. Una richiesta restituisce immediatamente l'esito positivo senza restituire ERROR_PENDING. Quando il parametro FileHandle è un socket, questa modalità è compatibile solo con provider di servizi a livelli (LSP) che restituiscono handle IFS (Installable File Systems). Per rilevare se è installato un LSP non IFS, usare la funzione WSAEnumProtocols ed esaminare il membro dwServiceFlag1 in ogni struttura WSAPROTOCOL_INFO restituita. Se il bit XP1_IFS_HANDLES (0x20000 ) viene cancellato, l'LSP specificato non è un LSP IFS. I fornitori che dispongono di LSP non IFS sono invitati a eseguire la migrazione alla piattaforma di filtro di Windows (WFP).
FILE_SKIP_SET_EVENT_ON_HANDLE 0x2	Gestione I/O non imposta l'evento per l'oggetto file se una richiesta restituisce un codice di esito positivo oppure l'errore restituito è ERROR_PENDING e la funzione chiamata non è una funzione sincrona. Se viene fornito un evento esplicito per la richiesta, viene comunque segnalato.

Valore

Significato

FILE_SKIP_COMPLETION_PORT_ON_SUCCESS
0x1

Se le tre condizioni seguenti sono vere, gestione I/O non accoda una voce di completamento alla porta, quando si intende eseguire normalmente. Le condizioni sono:

Una porta di completamento è associata all'handle di file.
Il file viene aperto per I/O asincrono.
Una richiesta restituisce immediatamente l'esito positivo senza restituire ERROR_PENDING.

Quando il parametro FileHandle è un socket, questa modalità è compatibile solo con provider di servizi a livelli (LSP) che restituiscono handle IFS (Installable File Systems). Per rilevare se è installato un LSP non IFS, usare la funzione WSAEnumProtocols ed esaminare il membro dwServiceFlag1 in ogni struttura WSAPROTOCOL_INFO restituita. Se il bit XP1_IFS_HANDLES (0x20000 ) viene cancellato, l'LSP specificato non è un LSP IFS. I fornitori che dispongono di LSP non IFS sono invitati a eseguire la migrazione alla piattaforma di filtro di Windows (WFP).

FILE_SKIP_SET_EVENT_ON_HANDLE
0x2

Gestione I/O non imposta l'evento per l'oggetto file se una richiesta restituisce un codice di esito positivo oppure l'errore restituito è ERROR_PENDING e la funzione chiamata non è una funzione sincrona.

Se viene fornito un evento esplicito per la richiesta, viene comunque segnalato.

Valore restituito

Restituisce un valore diverso da zero se ha esito positivo o zero in caso contrario.

Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Per compilare un'applicazione che usa questa funzione, definire la macro _WIN32_WINNT come 0x0600 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia	Supportato
Protocollo SMB (Server Message Block) 3.0	Sì
Failover trasparente SMB 3.0 (TFO)	Sì
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	Sì
File system del volume condiviso del cluster (CsvFS)	Sì
File system resiliente (ReFS)	Sì

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Funzioni di gestione file

Condividi tramite