FilterConnectCommunicationPort-Funktion (fltuser.h)
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 |
---|---|
|
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.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
Header | fltuser.h (fltuser.h einschließen) |
Bibliothek | FltLib.lib |
DLL | FltLib.dll |