Partager via

PADD_INTERFACE fonction de rappel (routprot.h)

  • Article

La fonction AddInterface ajoute une interface à gérer par le protocole de routage. Le protocole doit considérer l’interface comme étant dans un état désactivé. Le gestionnaire de routeur active l’interface en appelant InterfaceStatus avec l’indicateur RIS_INTERFACE_ENABLED.

Lorsqu’un utilisateur appelle MprAdminInterfaceTransportAdd, le gestionnaire d’interface dynamique pour le transport appelle le gestionnaire de routeur (pour le transport) qui appelle cette fonction pour chacun des protocoles de routage associés à ce transport.

Syntaxe

PADD_INTERFACE PaddInterface;

DWORD PaddInterface(
  [in] LPWSTR InterfaceName,
  [in] ULONG InterfaceIndex,
  [in] NET_INTERFACE_TYPE InterfaceType,
  [in] DWORD MediaType,
  [in] WORD AccessType,
  [in] WORD ConnectionType,
  [in] PVOID InterfaceInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

Paramètres

[in] InterfaceName

Pointeur vers une chaîne Unicode. La chaîne contient un nom qui identifie de façon unique l’interface dans l’ensemble d’interfaces configurées sur le routeur.

[in] InterfaceIndex

Spécifie l’interface dans l’ensemble d’interfaces configurées sur le routeur.

[in] InterfaceType

Spécifie le type de l’interface.

Valeur Signification
PERMANENT
 Connectivité permanente (par exemple, LAN, Frame Relay).
DEMAND_DIAL
 Connectivité de numérotation à la demande (analogique, ISDN, PPTP, FR commuté).
LOCAL_WORKSTATION_DIAL
 Connectivité de station de travail locale uniquement.
REMOTE_WORKSTATION_DIAL
 Connectivité des stations de travail distantes uniquement.

[in] MediaType

Réservé à un usage ultérieur.

[in] AccessType

Réservé à un usage ultérieur.

[in] ConnectionType

Réservé à un usage ultérieur.

[in] InterfaceInfo

Pointeur vers une mémoire tampon qui spécifie les informations de configuration définies par le protocole associées à l’interface. Ces informations sont privées au protocole de routage.

[in] StructureVersion

Spécifie la version des structures d’informations pointées vers le paramètre InterfaceInfo . Dans certains cas, cela est égal à la version du protocole de routage.

[in] StructureSize

Spécifie la taille de chacune des structures d’informations pointées par le paramètre InterfaceInfo . Étant donné que certaines structures d’informations contiennent des membres de longueur variable, le protocole de routage n’est pas nécessairement en mesure de déterminer la taille des informations à partir de la version.

[in] StructureCount

Spécifie le nombre de structures d’informations pointées par le paramètre InterfaceInfo . Ce paramètre en est toujours un.

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.

Valeur Description
ERROR_CAN_NOT_COMPLETE
 La tentative d’ajout de l’interface a échoué.
ERROR_INVALID_PARAMETER
 Le paramètre InterfaceIndex n’est pas valide (par exemple, une interface avec cet index existe déjà), ou l’un des paramètres pointés par InterfaceInfo n’est pas valide.
 
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête routprot.h

Voir aussi

DeleteInterface

Fonctions d’interface de protocole de routage

Informations de référence sur l’interface de protocole de routage