MprConfigFilterGetInfo-Funktion (mprapi.h)

Artikel
08/24/2023

Die Funktion MprConfigFilterGetInfo gibt statische Filterinformationen für einen angegebenen Transportprotokolltyp zurück.

Syntax

DWORD MprConfigFilterGetInfo(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  DWORD  dwTransportId,
  [out] LPBYTE lpBuffer
);

Parameter

[in] hMprConfig

Handle für die Routerkonfiguration. Rufen Sie dieses Handle ab, indem Sie MprConfigServerConnect aufrufen.

[in] dwLevel

Ein DWORD-Wert , der das Format beschreibt, in dem die Informationen im lpBuffer-Parameter zurückgegeben werden. Muss Null sein.

[in] dwTransportId

Ein DWORD-Wert , der den Transportprotokolltyp der statischen Filterinformationen im lpBuffer-Parameter beschreibt. Zulässige Werte für dwTransportId sind in der folgenden Tabelle aufgeführt.

Wert	Transport (Protokollfamilie)
PID_ATALK	Appletalk
PID_IP	Internetprotokoll, Version 4
PID_IPX	Internet-Paketaustausch
PID_NBF	NetBIOS Frames-Protokoll
PID_IPV6	Windows Server 2008 oder höher: Internetprotokoll, Version 6

[out] lpBuffer

Bei erfolgreicher Fertigstellung ein Zeiger auf eine MPR_FILTER_0 Struktur, die die Konfigurationsinformationen des Filtertreibers enthält. Geben Sie diesen Speicherpuffer frei, indem Sie MprConfigBufferFree aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	hMprConfig oder lpBuffer ist NULL, oder dwLevel ist nicht auf 0 festgelegt.

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h
Bibliothek	Mprapi.lib
DLL	Mprapi.dll

Weitere Informationen

MPR_FILTER_0

MprConfigFilterSetInfo

Freigeben über