FltCloseCommunicationPort-Funktion (fltkernel.h)

FltCloseCommunicationPort schließt den Kommunikationsserverport eines Minifiltertreibers.

Syntax

VOID FLTAPI FltCloseCommunicationPort(
  [in] PFLT_PORT ServerPort
);

Parameter

[in] ServerPort

Undurchsichtiges Porthandle für den zu schließenden Serverport. Dieser Parameter ist erforderlich und darf nicht NULL sein.

Rückgabewert

Keine

Bemerkungen

FltCloseCommunicationPort schließt einen Kommunikationsserverport, der durch einen vorherigen Aufruf von FltCreateCommunicationPort erstellt wurde.

Ein Minifiltertreiber ruft fltCloseCommunicationPort normalerweise aus seiner FilterUnloadCallback-Routine (PFLT_FILTER_UNLOAD_CALLBACK) auf.

Nachdem FltCloseCommunicationPort aufgerufen wurde, ist das durch den ServerPort-Parameter angegebene undurchsichtige Porthandle nicht mehr gültig und kann nicht sicher verwendet werden. (Das ServerPort-Handle ist für den Kommunikationsserverport vorgesehen, über den der Minifiltertreiber auf eingehende Verbindungen lauscht.)

Wenn der Port des Kommunikationsservers geschlossen wird, sind vorhandene Verbindungen nicht betroffen. Es werden jedoch keine weiteren eingehenden Verbindungen akzeptiert.

Diese Routine schließt das Handle für den Serverport des Minifiltertreibers, der auf eingehende Verbindungen lauscht. Verwenden Sie FltCloseClientPort, um eine bestimmte Verbindung mit dem Minifiltertreiber zu trennen.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header fltkernel.h (fltkernel.h einschließen)
Bibliothek Fltmgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Weitere Informationen

FilterConnectCommunicationPort

FltCloseClientPort

FltCreateCommunicationPort

FltSendMessage

PFLT_FILTER_UNLOAD_CALLBACK