MprAdminInterfaceSetCustomInfoEx, fonction (mprapi.h)

Article
02/29/2024

Définit la configuration personnalisée spécifique au tunnel pour une interface de numérotation à la demande spécifiée sur un serveur spécifié.

Syntaxe

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

Paramètres

[in] hMprServer

Handle du routeur à interroger. Ce handle est obtenu par un appel précédent à la fonction MprAdminServerConnect .

[in] hInterface

Handle de l’interface. Ce handle est obtenu par un appel précédent à la fonction MprAdminInterfaceCreate ou à la fonction MprAdminInterfaceGetHandle .

[in] pCustomInfo

Pointeur vers une structure MPR_IF_CUSTOMINFOEX qui contient une configuration personnalisée spécifique au tunnel.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR. Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_ACCESS_DENIED	L’application appelante ne dispose pas de privilèges suffisants.
ERROR_INVALID_HANDLE	La valeur hInterface n’est pas valide.
ERROR_INVALID_PARAMETER	Le paramètre pCustomInfo est NULL ou le type d’interface n’est pas ROUTER_IF_TYPE_FULL_ROUTER.
ERROR_NOT_ENOUGH_MEMORY	Les ressources étaient insuffisantes pour terminer l’opération.

Remarques

Si vous devez supprimer la configuration personnalisée pour le tunnel IKEv2 d’une interface, appelez la fonction MprAdminInterfaceSetCustomInfoEx avec le membre dwFlags de la structure MPR_IF_CUSTOMINFOEX défini sur zéro.

Si vous devez supprimer la configuration du mode main IKEv2 et du mode rapide pour une interface, définissez le paramètre customPolicy du membre customIkev2Config dans MPR_IF_CUSTOMINFOEX structure sur NULL.

Si vous devez supprimer le certificat configuré pour être utilisé pendant la négociation SA en mode main IKEv2, définissez le membre cbData de certificateName dans customIkev2Config membre de MPR_IF_CUSTOMINFOEX structure sur 0.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mprapi.h
Bibliothèque	Mprapi.lib
DLL	Mprapi.dll

Voir aussi

Fonctions d’administration du routeur

Informations de référence sur la gestion des routeurs

Partager via