Partager via


Fonction MprAdminTransportSetInfo (mprapi.h)

La fonction MprAdminTransportSetInfo définit des informations globales, ou des informations d’interface client par défaut, ou les deux, pour un transport spécifié.

Syntaxe

DWORD MprAdminTransportSetInfo(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in]           DWORD             dwClientInterfaceInfoSize
);

Paramètres

[in] hMprServer

Gérez le routeur sur lequel les informations sont définies. Ce handle est obtenu à partir d’un appel précédent à MprAdminServerConnect.

[in] dwTransportId

Valeur DWORD qui décrit le type de transport à définir. Les valeurs acceptables pour dwTransportId sont répertoriées dans le tableau suivant.

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

[in, optional] pGlobalInfo

Pointeur vers une mémoire tampon qui spécifie des informations globales pour le transport. Utilisez les fonctions d’en-tête d’informations pour manipuler les en-têtes d’informations.

Ce paramètre est facultatif. Si l’application appelante spécifie NULL pour ce paramètre, la fonction ne définit pas les informations globales.

[in] dwGlobalInfoSize

Spécifie la taille, en octets, de la mémoire tampon pointée vers le paramètre pGlobalInfo .

[in, optional] pClientInterfaceInfo

Pointeur vers une mémoire tampon qui spécifie les informations d’interface client par défaut pour le transport.

Ce paramètre est facultatif. Si l’application appelante spécifie NULL pour ce paramètre, la fonction ne définit pas les informations d’interface client par défaut.

[in] dwClientInterfaceInfoSize

Spécifie la taille, en octets, de la mémoire tampon pointée vers le paramètre pClientInterfaceInfo .

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_PARAMETER
Le paramètre pGlobalInfo et le paramètre pClientInterfaceInfo sont tous deux NULL.
ERROR_NOT_ENOUGH_MEMORY
Ressources insuffisantes pour terminer l’opération.
ERROR_UNKNOWN_PROTOCOL_ID
La valeur dwTransportId ne correspond à aucun protocole de transport pris en charge.

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

MprAdminServerConnect

MprAdminTransportGetInfo

Fonctions d’administration du routeur

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