Fonction MprAdminTransportCreate (mprapi.h)

Article
03/06/2024

La fonction MprAdminTransportCreate charge un nouveau transport et démarre le gestionnaire de routeur pour le transport.

Syntaxe

DWORD MprAdminTransportCreate(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPWSTR            lpwsTransportName,
  [in]           LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in, optional] DWORD             dwClientInterfaceInfoSize,
  [in]           LPWSTR            lpwsDLLPath
);

Paramètres

[in] hMprServer

Gérez le routeur sur lequel définir les informations. Obtenez ce handle en appelant MprAdminServerConnect.

[in] dwTransportId

Valeur DWORD qui décrit le type de configuration 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] lpwsTransportName

Pointeur vers une chaîne Unicode terminée par null qui spécifie le nom du transport.

[in] 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.

[in] dwGlobalInfoSize

Spécifie la taille, en octets, des données pointées par 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, optional] dwClientInterfaceInfoSize

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

[in] lpwsDLLPath

Pointeur vers une chaîne Unicode terminée par null qui spécifie le chemin d’accès à la DLL pour le transport.

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_PROTOCOL_ALREADY_INSTALLED	Le transport spécifié est déjà en cours d’exécution sur le routeur spécifié.
ERROR_UNKNOWN_PROTOCOL_ID	La valeur dwTransportId ne correspond à aucun protocole de 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

MprAdminTransportGetInfo

MprAdminTransportSetInfo

Partager via