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 kann nicht NULL-werden.
Rückgabewert
Nichts
Bemerkungen
FltCloseCommunicationPort schließt einen Kommunikationsserverport, der durch einen vorherigen Aufruf von FltCreateCommunicationPorterstellt wurde.
Ein Minifiltertreiber ruft normalerweise FltCloseCommunicationPort- aus seiner FilterUnloadCallback- (PFLT_FILTER_UNLOAD_CALLBACK) -Routine auf.
Nachdem FltCloseCommunicationPort aufgerufen wurde, ist das durch den ServerPort Parameter angegebene undurchsichtige Porthandle nicht mehr gültig und kann nicht sicher verwendet werden. (Der ServerPort- Handle ist für den Kommunikationsserverport bestimmt, den der Minifiltertreiber zum Überwachen eingehender Verbindungen verwendet.)
Wenn der Kommunikationsserverport geschlossen wird, sind vorhandene Verbindungen nicht betroffen. Eingehende Verbindungen werden jedoch nicht mehr akzeptiert.
Diese Routine schließt das Handle für den Serverport des Minifiltertreibers, der auf eingehende Verbindungen lauscht. Um eine bestimmte Verbindung vom Minifiltertreiber zu trennen, verwenden Sie FltCloseClientPort.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | Fltmgr.lib |
| DLL- | Fltmgr.sys |
| IRQL- | PASSIVE_LEVEL |