MprAdminInterfaceGetCustomInfoEx-Funktion (mprapi.h)

  • Artikel

Ruft die tunnelspezifische Konfiguration für eine angegebene Bedarfswählschnittstelle auf einem angegebenen Server ab.

Syntax

DWORD MprAdminInterfaceGetCustomInfoEx(
  [in]  MPR_SERVER_HANDLE    hMprServer,
  [in]  HANDLE               hInterface,
  [out] PMPR_IF_CUSTOMINFOEX pCustomInfo
);

Parameter

[in] hMprServer

Ein Handle für den abzufragenden Router. Dieses Handle wird durch einen vorherigen Aufruf der Funktion MprAdminServerConnect abgerufen.

[in] hInterface

Ein Handle für die Schnittstelle. Dieses Handle wird durch einen vorherigen Aufruf der Funktion MprAdminInterfaceCreate abgerufen.

[out] pCustomInfo

Ein Zeiger auf eine MPR_IF_CUSTOMINFOEX-Struktur . Wenn Sie die Verwendung der -Struktur abgeschlossen haben, geben Sie den Arbeitsspeicher frei, indem Sie die Funktion 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.

Rückgabecode Beschreibung
ERROR_ACCESS_DENIED
 Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.
ERROR_INVALID_HANDLE
 Der hInterface-Wert ist ungültig.
ERROR_INVALID_PARAMETER
 Der hInterface-Wert ist ungültig, oder wenn der Schnittstellentyp nicht ROUTER_IF_TYPE_FULL_ROUTER ist.
ERROR_NOT_ENOUGH_MEMORY
 Es gab nicht genügend Ressourcen, um den Vorgang abzuschließen.

Anforderungen

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

Weitere Informationen

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung