Partager via


MprAdminInterfaceTransportRemove, fonction (mprapi.h)

La fonction MprAdminInterfaceTransportRemove supprime un transport (par exemple, IP ou IPX) d’une interface spécifiée.

Syntaxe

DWORD MprAdminInterfaceTransportRemove(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwTransportId
);

Paramètres

[in] hMprServer

Handle vers le routeur à partir duquel le transport est supprimé. Obtenez ce handle en appelant MprAdminServerConnect.

[in] hInterface

Handle vers l’interface à partir de laquelle le transport est supprimé. Obtenez ce handle en appelant MprAdminInterfaceCreate.

[in] dwTransportId

Valeur DWORD qui décrit le type de transport à supprimer. 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

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_INTERFACE_CONNECTED
L’interface spécifiée est une interface de numérotation à la demande et est actuellement connectée.
ERROR_INVALID_HANDLE
La valeur hInterface n’est pas valide.
ERROR_NO_SUCH_INTERFACE
Le transport spécifié n’est pas en cours d’exécution sur l’interface spécifiée.
ERROR_UNKNOWN_PROTOCOL_ID
La valeur dwTransportId ne correspond à aucun transport pris en charge.

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

Voir aussi

MprAdminInterfaceCreate

MprAdminInterfaceTransportAdd

MprAdminServerConnect

Fonctions d’administration du routeur

Informations de référence sur la gestion des routeurs