MprAdminInterfaceTransportAdd, fonction (mprapi.h)

Article
08/24/2023

La fonction MprAdminInterfaceTransportAdd ajoute un transport (par exemple, IP ou IPX) à une interface spécifiée.

Syntaxe

DWORD MprAdminInterfaceTransportAdd(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwTransportId,
  [in] LPBYTE            pInterfaceInfo,
  [in] DWORD             dwInterfaceInfoSize
);

Paramètres

[in] hMprServer

Handle au routeur sur lequel les informations sont ajoutées. Obtenez ce handle en appelant MprAdminServerConnect.

[in] hInterface

Handle à l’interface sur laquelle le transport est ajouté. Ce handle est obtenu par un appel précédent à MprAdminInterfaceCreate.

[in] dwTransportId

Valeur DWORD qui décrit le type de transport à ajouter à l’interface. 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] pInterfaceInfo

Pointeur vers un en-tête d’informations qui spécifie les informations d’interface pour ce transport. 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 informations pointées par pInterfaceInfo.

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_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 pInterfaceInfo est NULL.
ERROR_UNKNOWN_PROTOCOL_ID	La valeur dwTransportId ne correspond à aucun transport pris en charge.

Notes

Le paramètre dwTransportId spécifie également le gestionnaire de routeur, car un routeur utilise un gestionnaire de routeur différent pour chaque transport.

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