MprConfigInterfaceGetInfo-Funktion (mprapi.h)

Artikel
08/24/2023

Die MprConfigInterfaceGetInfo-Funktion ruft die Konfiguration für die angegebene Schnittstelle vom Router ab.

Syntax

DWORD MprConfigInterfaceGetInfo(
  [in]      HANDLE  hMprConfig,
  [in]      HANDLE  hRouterInterface,
  [in]      DWORD   dwLevel,
  [in, out] LPBYTE  *lplpBuffer,
  [out]     LPDWORD lpdwBufferSize
);

Parameter

[in] hMprConfig

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

[in] hRouterInterface

Handle mit der Schnittstellenkonfiguration, für die Informationen abgerufen werden sollen. Rufen Sie dieses Handle ab, indem Sie MprConfigInterfaceCreate, MprConfigInterfaceGetHandle oder MprConfigInterfaceEnum aufrufen.

[in] dwLevel

Ein DWORD-Wert, der das Format beschreibt, in dem die Informationen im lplpBuffer-Parameter zurückgegeben werden. Zulässige Werte für dwLevel sind 0, 1, 2 und 3, wie in der folgenden Tabelle aufgeführt.

Wert	Strukturformat
0	MPR_INTERFACE_0
1	MPR_INTERFACE_1
2	MPR_INTERFACE_2
3	Windows Server 2008 oder höher: MPR_INTERFACE_3

[in, out] lplpBuffer

Bei der Eingabe ein Nicht-NULL-Zeiger .

Bei erfolgreicher Fertigstellung ein Zeiger auf ein Array von MPR_INTERFACE_0 , MPR_INTERFACE_1,
MPR_INTERFACE_2 oder MPR_INTERFACE_3 Struktur. Der dwLevel-Parameter gibt den Typ der Struktur an. Geben Sie diesen Puffer frei, indem Sie MprConfigBufferFree aufrufen.

[out] lpdwBufferSize

Zeiger auf eine DWORD-Variable . Diese Variable empfängt die Größe der über lplpBuffer zurückgegebenen Daten in Bytes.

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.

Wert	Bedeutung
ERROR_INVALID_PARAMETER	Mindestens eine der folgenden Optionen muss zutreffen: hMprConfig ist NULL. hRouterInterface ist NULL. dwLevel ist nicht 0, 1, 2 oder 3. lplpBuffer ist NULL. lpdwBufferSize ist NULL.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen zum Abschließen des Vorgangs.
ERROR_NO_SUCH_INTERFACE	Die Schnittstelle, die hRouterInterface entspricht, ist in der Routerkonfiguration nicht vorhanden.

Anforderungen


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