MprAdminInterfaceSetCustomInfoEx-Funktion (mprapi.h)

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.

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

Weitere Informationen

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung