FilterConnectCommunicationPort 函式 (fltuser.h)

發行項
02/29/2024

FilterConnectCommunicationPort 會開啟與文件系統迷你篩選器所建立之通訊伺服器埠的新連線。

語法

HRESULT FilterConnectCommunicationPort(
  [in]           LPCWSTR               lpPortName,
  [in]           DWORD                 dwOptions,
  [in, optional] LPCVOID               lpContext,
  [in]           WORD                  wSizeOfContext,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [out]          HANDLE                *hPort
);

參數

[in] lpPortName

NULL 終止寬字元字串的指標，其中包含通訊伺服器埠的完整名稱 (，例如 L“\MyFilterPort”) 。

[in] dwOptions

通訊埠的連線選項。在 Windows 8.1 之前，此值會設定為 0。

值	意義
FLT_PORT_FLAG_SYNC_HANDLE	hPort 中傳回的句柄適用於同步 I/O。從 Windows 8.1 開始，即可使用此旗標。

[in, optional] lpContext

要傳遞至核心模式迷你篩選程序的連線通知例程的呼叫端提供內容資訊的指標。 (在 FltCreateCommunicationPort.) 此參數的參考頁面中查看 ConnectNotifyCallback 參數是選擇性的，而且可以是 NULL。

[in] wSizeOfContext

lpContext 參數指向之結構的大小，以位元組為單位。如果 lpContext 的值不是 NULL，這個參數必須是非零值。如果 lpContext 為 NULL，這個參數必須是零。

[in, optional] lpSecurityAttributes

SECURITY ATTRIBUTES 結構的指標，這個結構會判斷子處理序是否可以繼承傳回的控制代碼。如需SECURITY_ATTRIBUTES結構的詳細資訊，請參閱 Microsoft Windows SDK 檔。此參數是選擇性的，可以是 NULL。如果此參數為 NULL，則無法繼承句柄。

[out] hPort

呼叫端配置的變數指標，如果 FilterConnectCommunicationPort 的呼叫成功，就會接收新建立之連線埠的句柄;否則，它會收到INVALID_HANDLE_VALUE。

傳回值

如果成功，FilterConnectCommunicationPort 會傳回S_OK。否則，它會傳回錯誤值。

備註

FilterConnectCommunicationPort 會代表使用者模式應用程式開啟與迷你篩選器通訊伺服器埠的連線。應用程式會使用產生的連線埠句柄來與迷你篩選器通訊。

成功呼叫 FilterConnectCommunicationPort 之後，應用程式可以藉由呼叫 FilterSendMessage，透過連線埠將訊息傳送至迷你篩選器。它也可以分別呼叫 FilterGetMessage 和 FilterReplyMessage，以接收和回復來自迷你篩選的訊息。 hPort 參數中傳回的連接埠句柄會當做第一個參數傳遞至 FilterSendMessage、FilterGetMessage 和 FilterReplyMessage。

從 FilterConnectCommunicationPort 取得的任何句柄最終都必須藉由呼叫 CloseHandle 來釋放。