MprAdminInterfaceGetCustomInfoEx-Funktion (mprapi.h)

Artikel
02/29/2024

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

Freigeben über