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 |