FltCloseClientPort 函数 (fltkernel.h)

项目
08/07/2023

FltCloseClientPort 关闭通信客户端端口。

语法

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

参数

[in] Filter

调用方不透明的筛选器指针。此参数是必需的，不能为 NULL。

[out] ClientPort

指向变量的指针，该变量包含要关闭的客户端端口的不透明端口句柄。返回时，变量接收 NULL。此参数是必需的，输入时不能为 NULL 。

返回值

无

备注

微筛选器驱动程序通常从在调用 FltCreateCommunicationPort 时注册的 DisconnectNotifyCallback 例程调用 FltCloseClientPort。每当客户端端口的用户模式句柄计数达到零或即将卸载微筛选器驱动程序时，筛选器管理器都会调用 DisconnectNotifyCallback 例程。

FltCloseClientPort 关闭由微筛选器驱动程序的 ConnectNotifyCallback 例程创建的通信客户端端口。

输入时， ClientPort 参数是指向变量的指针，其中包含要关闭的客户端端口的不透明句柄。为了确保在通信客户端端口关闭时正确同步 FltSendMessage 发送的任何消息， FltCloseClientPort 将此变量设置为 NULL。

此例程断开特定连接与微筛选器驱动程序的连接。若要关闭用于侦听传入连接的微筛选器驱动程序服务器端口的句柄，请使用 FltCloseCommunicationPort。