FilterConnectCommunicationPort-Funktion (fltuser.h)

Artikel
03/01/2024

FilterConnectCommunicationPort öffnet eine neue Verbindung mit einem Kommunikationsserverport, der von einem Dateisystem-Minifilter erstellt wird.

Syntax

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

Parameter

[in] lpPortName

Zeiger auf eine MIT NULL beendete Breitzeichenzeichenfolge, die den vollqualifizierten Namen des Kommunikationsserverports enthält (z. B. L"\MyFilterPort").

[in] dwOptions

Verbindungsoptionen für den Kommunikationsport. Vor Windows 8.1 wird dieser Wert auf 0 festgelegt.

Wert	Bedeutung
FLT_PORT_FLAG_SYNC_HANDLE	Das in hPort zurückgegebene Handle ist für synchrone E/A-Vorgänge. Dieses Flag ist ab Windows 8.1 verfügbar.

[in, optional] lpContext

Zeiger auf vom Aufrufer bereitgestellte Kontextinformationen, die an die Verbindungsbenachrichtigungsroutine des Minifilters im Kernelmodus übergeben werden sollen. (Weitere Informationen finden Sie im ConnectNotifyCallback-Parameter auf der Referenzseite für FltCreateCommunicationPort.) Dieser Parameter ist optional und kann NULL sein.

[in] wSizeOfContext

Größe der Struktur, auf die der lpContext-Parameter verweist, in Byte. Wenn der Wert von lpContext ungleich NULL ist, muss dieser Parameter ungleich null sein. Wenn lpContextNULL ist, muss dieser Parameter null sein.

[in, optional] lpSecurityAttributes

Zeiger auf eine SECURITY_ATTRIBUTES-Struktur, die bestimmt, ob das zurückgegebene Handle von untergeordneten Prozessen geerbt werden kann. Weitere Informationen zur SECURITY_ATTRIBUTES-Struktur finden Sie in der Microsoft Windows SDK-Dokumentation. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter NULL ist, kann das Handle nicht geerbt werden.

[out] hPort

Zeiger auf eine vom Aufrufer zugewiesene Variable, die ein Handle für den neu erstellten Verbindungsport empfängt, wenn der Aufruf von FilterConnectCommunicationPort erfolgreich ist; Andernfalls empfängt sie INVALID_HANDLE_VALUE.

Rückgabewert

FilterConnectCommunicationPort gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein Fehlerwert zurückgegeben.

Hinweise

FilterConnectCommunicationPort öffnet eine Verbindung mit dem Kommunikationsserverport eines Minifilters im Namen einer Benutzermodusanwendung. Die Anwendung verwendet das resultierende Verbindungsporthandle, um mit dem Minifilter zu kommunizieren.

Nachdem FilterConnectCommunicationPort erfolgreich aufgerufen wurde, kann die Anwendung Nachrichten über den Verbindungsport durch Aufrufen von FilterSendMessage an den Minifilter senden. Es kann auch Nachrichten vom Minifilter empfangen und beantworten, indem FilterGetMessage bzw . FilterReplyMessage aufgerufen wird. Das im hPort-Parameter zurückgegebene Verbindungsporthandle wird als erster Parameter an FilterSendMessage, FilterGetMessage und FilterReplyMessage übergeben.

Jedes Handle, das von FilterConnectCommunicationPort abgerufen wird, muss schließlich durch Aufrufen von CloseHandle freigegeben werden.