FltCloseClientPort 函式 (fltkernel.h)

發行項
02/26/2024

FltCloseClientPort 會關閉通訊用戶端埠。

語法

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

參數

[in] Filter

呼叫端的不透明篩選指標。這個參數是必要的，而且不能是 NULL。

[out] ClientPort

變數的指標，其中包含要關閉之用戶端埠的不透明埠句柄。傳回時，變數會收到 NULL。這是必要參數，而且在輸入上不能是 NULL 。

傳回值

無

備註

minifilter 驅動程式通常會從名為 FltCreateCommunicationPort 時所註冊的 DisconnectNotifyCallback 例程呼叫 FltCloseClientPort。每當用戶端埠的使用者模式句柄計數達到零或即將卸除迷你篩選驅動程式時，篩選管理員就會呼叫 DisconnectNotifyCallback 例程。

FltCloseClientPort 會關閉由迷你篩選器驅動程式的 ConnectNotifyCallback 例程所建立的通訊用戶端埠。

在輸入時， ClientPort 參數是變數的指標，其中包含要關閉之用戶端埠的不透明句柄。為了確保當通訊用戶端埠關閉時， FltSendMessage 所傳送的任何訊息都會正確同步處理， FltCloseClientPort 會將此變數設定為 NULL。

此例程會中斷與迷你篩選驅動程式的特定連線。若要關閉迷你篩選驅動程式伺服器埠的句柄，它會接聽連入連線，請使用 FltCloseCommunicationPort。