MprAdminInterfaceSetCustomInfoEx-Funktion (mprapi.h)

Artikel
03/04/2024

Legt die tunnelspezifische benutzerdefinierte Konfiguration für eine angegebene Bedarfswählschnittstelle auf einem angegebenen Server fest.

Syntax

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

Parameter

[in] hMprServer

Das Handle für den router, der abgefragt werden soll. Dieses Handle wird durch einen vorherigen Aufruf der Funktion MprAdminServerConnect abgerufen.

[in] hInterface

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

[in] pCustomInfo

Ein Zeiger auf eine MPR_IF_CUSTOMINFOEX-Struktur , die tunnelspezifische benutzerdefinierte Konfiguration enthält.

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 pCustomInfo-Parameter ist NULL , oder der Schnittstellentyp ist nicht ROUTER_IF_TYPE_FULL_ROUTER.
ERROR_NOT_ENOUGH_MEMORY	Es waren nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen.

Hinweise

Wenn Sie die benutzerdefinierte Konfiguration für den IKEv2-Tunnel einer Schnittstelle löschen müssen, rufen Sie die MprAdminInterfaceSetCustomInfoEx-Funktion auf, wobei der dwFlags-Member der MPR_IF_CUSTOMINFOEX-Struktur auf 0 festgelegt ist.

Wenn Sie die Richtlinienkonfiguration IKEv2 Standard Modus und Schnellmodus für eine Schnittstelle löschen müssen, legen Sie den customPolicy-Parameter des customIkev2Config-Members in MPR_IF_CUSTOMINFOEX Struktur auf NULL fest.

Wenn Sie das Zertifikat löschen müssen, das für die Verwendung während der IKEv2-Standard-Modus-SA-Aushandlung konfiguriert ist, legen Sie das cbData-Mitglied von certificateName im customIkev2Config-MemberMPR_IF_CUSTOMINFOEX Struktur auf 0 fest.

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