MprConfigInterfaceGetCustomInfoEx-Funktion (mprapi.h)

Artikel
02/29/2024

Ruft die benutzerdefinierte IKEv2-Richtlinienkonfiguration für die angegebene Schnittstelle ab.

Syntax

DWORD MprConfigInterfaceGetCustomInfoEx(
  [in]  HANDLE               hMprConfig,
  [in]  HANDLE               hRouterInterface,
  [out] PMPR_IF_CUSTOMINFOEX pCustomInfo
);

Parameter

[in] hMprConfig

Das Handle für die Routerkonfiguration. Dieses Handle wird durch Aufrufen der MprConfigServerConnect-Funktion abgerufen.

[in] hRouterInterface

Das Handle für die Schnittstellenkonfiguration, die aktualisiert wird. Rufen Sie dieses Handle ab, indem Sie die MprConfigInterfaceCreate-Funktion , die MprConfigInterfaceGetHandle-Funktion oder die MprConfigInterfaceEnum-Funktion aufrufen.

[out] pCustomInfo

Ein Zeiger auf eine MPR_IF_CUSTOMINFOEX-Struktur . Wenn Sie die Verwendung der -Struktur abgeschlossen haben, geben Sie den Puffer frei, indem Sie die MprConfigBufferFree-Funktion 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_INVALID_PARAMETER	Mindestens eine der folgenden Optionen muss zutreffen: Der hMprConfig-Parameter ist NULL. Der hRouterInterface-Parameter ist NULL. Der pCustomInfo-Parameter ist NULL.
ERROR_NOT_ENOUGH_MEMORY	Es gab nicht genügend Ressourcen, um den Vorgang abzuschließen.
ERROR_NO_SUCH_INTERFACE	Die Schnittstelle, die dem hRouterInterface-Parameter entspricht, ist in der Routerkonfiguration nicht vorhanden.

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

Routerkonfigurationsfunktionen

Referenz zur Routerverwaltung

Freigeben über