Partager via


MprAdminInterfaceSetCustomInfoEx, fonction (mprapi.h)

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