MprConfigInterfaceTransportAdd, fonction (mprapi.h)

Article
08/24/2023

La fonction MprConfigInterfaceTransportAdd ajoute un protocole de transport à une configuration d’interface sur le routeur.

Syntaxe

DWORD MprConfigInterfaceTransportAdd(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pInterfaceInfo,
  [in]           DWORD  dwInterfaceInfoSize,
  [out]          HANDLE *phRouterIfTransport
);

Paramètres

[in] hMprConfig

Gérez la configuration du routeur. Obtenez ce handle en appelant MprConfigServerConnect.

[in] hRouterInterface

Handle à la configuration de l’interface à laquelle le transport spécifié est ajouté. Obtenez ce handle en appelant MprConfigInterfaceCreate, MprConfigInterfaceGetHandle ou MprConfigInterfaceEnum.

[in] dwTransportId

Valeur DWORD qui décrit le transport à ajouter à la configuration. Ce paramètre identifie également le gestionnaire de routeur pour le transport. Les valeurs acceptables pour dwTransportId sont répertoriées dans le tableau suivant.

Valeur	Transport (famille de protocoles)
PID_ATALK	Appletalk
PID_IP	Protocole Internet version 4
PID_IPX	Internet Packet Exchange
PID_NBF	NetBIOS Frames Protocol
PID_IPV6	Windows Server 2008 ou version ultérieure : Protocole Internet version 6

[in, optional] lpwsTransportName

Pointeur vers une chaîne Unicode terminée par un caractère Null qui spécifie le nom du transport en cours d’ajout. Si ce paramètre n’est pas spécifié et que le transport est IP ou IPX, MprConfigInterfaceTransportAdd utilise IP ou IPX. Si ce paramètre n’est pas spécifié et que le transport est autre qu’IP ou IPX, MprConfigInterfaceTransportAdd convertit le paramètre dwTransportId en chaîne et l’utilise comme nom de transport.

[in] pInterfaceInfo

Pointeur vers un en-tête d’informations qui contient des informations pour l’interface et le transport spécifiés. Le gestionnaire de routeur pour le transport spécifié interprète ces informations. Utilisez les fonctions d’en-tête d’informations pour manipuler les en-têtes d’informations.

[in] dwInterfaceInfoSize

Spécifie la taille, en octets, des données pointées par pInterfaceInfo.

[out] phRouterIfTransport

Pointeur vers un
VARIABLE HANDLE qui reçoit le type de handle de configuration de transport pour cette interface indiqué dans le paramètre dwTransportId .

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	Signification
ERROR_INVALID_PARAMETER	Une des conditions suivantes est vraie : hMprConfig a la valeur NULL. hRouterInterface a la valeur NULL. phRouterIfTransport a la valeur NULL.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.
Autres	Utilisez FormatMessage pour récupérer le message d’erreur système qui correspond au code d’erreur retourné.

Notes

En plus de spécifier un transport, le paramètre dwTransportId spécifie également un gestionnaire de routeur, car un routeur gère un gestionnaire de routeur unique pour chaque transport.

Si le transport spécifié existe déjà, MprConfigInterfaceTransportAdd effectue l’équivalent d’un appel MprConfigInterfaceTransportSetInfo à l’aide des valeurs de paramètre spécifiées.

Spécifications


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	mprapi.h
Bibliothèque	Mprapi.lib
DLL	Mprapi.dll