MprAdminInterfaceTransportAdd, fonction (mprapi.h)
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 |
|---|---|
|
L’application appelante ne dispose pas de privilèges suffisants. |
|
La valeur hInterface n’est pas valide. |
|
Le paramètre pInterfaceInfo est NULL. |
|
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 |
Voir aussi
MprAdminInterfaceTransportRemove