Freigeben über


MprAdminInterfaceGetInfo-Funktion (mprapi.h)

Die MprAdminInterfaceGetInfo-Funktion ruft Informationen für eine angegebene Schnittstelle auf einem angegebenen Server ab.

Syntax

DWORD MprAdminInterfaceGetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            *lplpbBuffer
);

Parameter

[in] hMprServer

Verarbeiten Sie den router, um abzufragen. Dieses Handle wird aus einem vorherigen Aufruf von MprAdminServerConnect abgerufen.

[in] hInterface

Behandeln Sie die Schnittstelle, die durch einen vorherigen Aufruf von MprAdminInterfaceCreate abgerufen wurde.

[in] dwLevel

Ein DWORD-Wert, der das Format beschreibt, in dem die Informationen im lplpbBuffer-Parameter strukturiert sind. 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
 

Die Werte 1, 2 und 3 gelten nur für Schnittstellen vom Typ ROUTER_CONNECTION_STATE.

[in] lplpbBuffer

Ein Zeiger auf eine 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 Arbeitsspeicher frei, indem Sie MprAdminBufferFree 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.

Wert Bedeutung
ERROR_ACCESS_DENIED
Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.
ERROR_INVALID_LEVEL
DwLevel ist 2, aber diese Ebene wird für die Schnittstelle nicht unterstützt. Beispielsweise ist der In der MPR_INTERFACE_X-Struktur definierte Schnittstellentyp nicht IF_TYPE_FULL_ROUTER.
ERROR_INVALID_HANDLE
Der hInterface-Wert ist ungültig.
ERROR_INVALID_PARAMETER
Der lplpbBuffer-Parameter ist NULL.
ERROR_NOT_ENOUGH_MEMORY
Unzureichende Ressourcen, um den Vorgang abzuschließen.
ERROR_NOT_SUPPORTED
Der dwLevel-Wert ist ungültig.

Anforderungen

Anforderung Wert
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

Weitere Informationen

MPR_INTERFACE_0

MPR_INTERFACE_1

MPR_INTERFACE_2

MPR_INTERFACE_3

MprAdminBufferFree

MprAdminInterfaceCreate

MprAdminServerConnect

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung