Funzione FltCloseClientPort (fltkernel.h)

Articolo
02/06/2025

FltCloseClientPort chiude una porta client di comunicazione.

Sintassi

VOID FLTAPI FltCloseClientPort(
  [in]  PFLT_FILTER Filter,
  [out] PFLT_PORT   *ClientPort
);

Parametri

[in] Filter

Puntatore di filtro opaco per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

[out] ClientPort

Puntatore a una variabile che contiene l'handle di porta opaca per la porta client da chiudere. In caso di restituzione, la variabile riceve NULL. Questo parametro è obbligatorio e non può essere NULL all'input.

Valore restituito

Nessuno

Osservazioni

Un driver minifilter chiama in genere FltCloseClientPort dalla routine DisconnectNotifyCallback registrata quando ha chiamato FltCreateCommunicationPort. Gestione filtri chiama la routine DisconnectNotifyCallback ogni volta che il numero di handle in modalità utente per la porta client raggiunge zero o quando il driver minifiltro sta per essere scaricato.

FltCloseClientPort chiude una porta client di comunicazione creata dalla routine ConnectNotifyCall back del driver minifiltro.

In caso di input, il parametro clientPort è un puntatore a una variabile contenente l'handle opaco per la porta client da chiudere. Per assicurarsi che tutti i messaggi inviati da FltSendMessage vengano sincronizzati correttamente quando la porta client di comunicazione viene chiusa, FltCloseClientPort imposta questa variabile su NULL.

Questa routine disconnette una connessione specifica dal driver minifilter. Per chiudere l'handle per la porta server del driver minifiltro, in ascolto delle connessioni in ingresso, usare FltCloseCommunicationPort.