FltCloseClientPort-Funktion (fltkernel.h)

Artikel
02/06/2025

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 kann nicht NULL-werden.

[out] ClientPort

Zeiger auf eine Variable, die den undurchsichtigen Porthandle für den zu schließenden Clientport enthält. Bei Rückgabe empfängt die Variable NULL-. Dieser Parameter ist erforderlich und kann bei eingaben nicht NULL- werden.

Rückgabewert

Nichts

Bemerkungen

Ein Minifiltertreiber ruft in der Regel FltCloseClientPort aus der DisconnectNotifyCallback Routine auf, die beim Aufrufen FltCreateCommunicationPortregistriert wurde. Der Filter-Manager ruft die DisconnectNotifyCallback- Routine auf, wenn die Anzahl der Benutzermodushandle für den Clientport null erreicht oder der Minifiltertreiber gerade entladen werden soll.

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

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

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