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 |
---|---|
|
L’application appelante ne dispose pas de privilèges suffisants. |
|
Le paramètre pGlobalInfo et le paramètre pClientInterfaceInfo sont tous deux NULL. |
|
Ressources insuffisantes pour terminer l’opération. |
|
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 |