FltCloseClientPort-Funktion (fltkernel.h)

Artikel
02/29/2024

FltCloseClientPort schließt einen Kommunikationsclientport.

Syntax

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

Parameter

[in] Filter

Undurchsichtiger Filterzeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[out] ClientPort

Zeiger auf eine Variable, die das undurchsichtige Porthandle für den zu schließenden Clientport enthält. Bei der Rückgabe empfängt die Variable NULL. Dieser Parameter ist erforderlich und kann bei der Eingabe nicht NULL sein.

Rückgabewert

Keine

Bemerkungen

Ein Minifiltertreiber ruft normalerweise FltCloseClientPort aus der DisconnectNotifyCallback-Routine auf, die er registriert hat, als er FltCreateCommunicationPort aufgerufen hat. Der Filter-Manager ruft die DisconnectNotifyCallback-Routine auf, wenn die Anzahl der Benutzermodushandles für den Clientport 0 erreicht oder wenn der Minifiltertreiber entladen werden soll.

FltCloseClientPort schließt einen Kommunikationsclientport, der von der ConnectNotifyCallback-Routine des Minifiltertreibers erstellt wurde.

Bei der Eingabe ist der ClientPort-Parameter ein Zeiger auf eine Variable, die das undurchsichtige Handle für den zu schließenden Clientport enthält. Um sicherzustellen, dass alle von FltSendMessage gesendeten Nachrichten ordnungsgemäß synchronisiert werden, wenn der Kommunikationsclientport geschlossen wird, legt FltCloseClientPort diese Variable auf NULL fest.

Diese Routine trennt eine bestimmte Verbindung vom Minifiltertreiber. Verwenden Sie FltCloseCommunicationPort, um das Handle für den Serverport des Minifiltertreibers zu schließen, der auf eingehende Verbindungen lauscht.