FilterConnectCommunicationPort-Funktion (fltuser.h)

Artikel
11/20/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 breite Zeichenfolge, die den vollqualifizierten Namen des Kommunikationsserverports enthält (z. B. L"\MyFilterPort").

[in] dwOptions

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

Wert	Bedeutung
FLT_PORT_FLAG_SYNC_HANDLE	Der in hPort- zurückgegebene Handle ist für synchrone E/A-. Dieses Kennzeichen ist ab Windows 8.1 verfügbar.

[in, optional] lpContext

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

[in] wSizeOfContext

Größe in Bytes der Struktur, auf die der lpContext Parameter verweist. Wenn der Wert von lpContext- nichtNULL-ist, muss dieser Parameter ungleich Null sein. Wenn lpContext-NULL-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-werden. 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 FilterConnectCommunication Port erfolgreich ist; andernfalls erhält sie INVALID_HANDLE_VALUE.

Rückgabewert

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

Bemerkungen

FilterConnectCommunicationPort öffnet eine Verbindung mit dem Kommunikationsserverport eines Minifilters im Auftrag einer Benutzermodusanwendung. Die Anwendung verwendet das resultierende Verbindungsporthandle für die Kommunikation mit dem Minifilter.

Nachdem die Anwendung FilterConnectCommunicationPorterfolgreich aufgerufen hat, kann die Anwendung Nachrichten über den Verbindungsport senden, indem sie FilterSendMessageaufruft. Sie kann auch Nachrichten vom Minifilter empfangen und beantworten, indem sie FilterGetMessage- und FilterReplyMessage-aufrufen. Das im hPort Parameter zurückgegebene Verbindungsporthandle wird als erster Parameter an FilterSendMessage, FilterGetMessageund FilterReplyMessageübergeben.

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