Función FltCloseClientPort (fltkernel.h)

Artículo
08/07/2023

FltCloseClientPort cierra un puerto de cliente de comunicación.

Sintaxis

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

Parámetros

[in] Filter

Puntero de filtro opaco para el autor de la llamada. Este parámetro es obligatorio y no puede ser NULL.

[out] ClientPort

Puntero a una variable que contiene el identificador de puerto opaco para que se cierre el puerto de cliente. A la devolución, la variable recibe NULL. Este parámetro es obligatorio y no puede ser NULL en la entrada.

Valor devuelto

None

Observaciones

Un controlador de minifiltro normalmente llama a FltCloseClientPort desde la rutina DisconnectNotifyCallback que registró cuando llamó a FltCreateCommunicationPort. El Administrador de filtros llama a la rutina DisconnectNotifyCallback cada vez que el número de identificadores del modo de usuario para el puerto de cliente alcanza cero o cuando el controlador de minifiltro está a punto de descargarse.

FltCloseClientPort cierra un puerto de cliente de comunicación creado por la rutina ConnectNotifyCallback del controlador de minifiltro.

En la entrada, el parámetro ClientPort es un puntero a una variable que contiene el identificador opaco para que se cierre el puerto de cliente. Para asegurarse de que los mensajes enviados por FltSendMessage se sincronizan correctamente cuando se cierra el puerto del cliente de comunicación, FltCloseClientPort establece esta variable en NULL.

Esta rutina desconecta una conexión específica del controlador de minifiltro. Para cerrar el identificador del puerto de servidor del controlador de minifiltro, que escucha las conexiones entrantes, use FltCloseCommunicationPort.