PADD_INTERFACE fonction de rappel (routprot.h)
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.
[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 |
---|---|
|
La tentative d’ajout de l’interface a échoué. |
|
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
Fonctions d’interface de protocole de routage
Informations de référence sur l’interface de protocole de routage
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour