Freigeben über


MprConfigInterfaceGetInfo-Funktion (mprapi.h)

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

Weitere Informationen

MprConfigBufferFree

MprConfigInterfaceErstellen

MprConfigInterfaceEnum

MprConfigInterfaceGetHandle

MprConfigServerConnect

Routerkonfigurationsfunktionen

Referenz zur Routerverwaltung