MprConfigTransportCreate, fonction (mprapi.h)

Article
08/24/2023

La fonction MprConfigTransportCreate ajoute le transport spécifié à la liste des protocoles de transport présents dans la configuration de routeur spécifiée.

Syntaxe

DWORD MprConfigTransportCreate(
  [in]           HANDLE hMprConfig,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pGlobalInfo,
  [in]           DWORD  dwGlobalInfoSize,
  [in, optional] LPBYTE pClientInterfaceInfo,
  [in, optional] DWORD  dwClientInterfaceInfoSize,
  [in, optional] LPWSTR lpwsDLLPath,
  [out]          HANDLE *phRouterTransport
);

Paramètres

[in] hMprConfig

Gérez la configuration du routeur à laquelle ajouter le transport. Obtenez ce handle en appelant MprConfigServerConnect.

[in] dwTransportId

Valeur DWORD qui décrit le transport à ajouter à la configuration. Ce paramètre identifie également le gestionnaire de routeur pour le transport. 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, optional] lpwsTransportName

Pointeur vers une chaîne Unicode terminée par un caractère Null qui spécifie le nom du transport ajouté. Si ce paramètre n’est pas spécifié, le paramètre dwTransportId est converti en chaîne et utilisé comme nom de transport.

[in] pGlobalInfo

Pointeur vers un en-tête d’informations qui spécifie des informations globales pour le transport. Le gestionnaire de routeur pour le transport interprète ces informations. 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 un en-tête d’informations qui spécifie les informations d’interface par défaut pour les routeurs clients. Ces informations sont utilisées pour configurer des interfaces dynamiques pour les routeurs clients pour ce transport. Utilisez les fonctions d’en-tête d’informations pour manipuler les en-têtes d’informations.

Ce paramètre est facultatif ; l’application appelante peut spécifier NULL pour ce paramètre.

[in, optional] dwClientInterfaceInfoSize

Spécifie la taille, en octets, des données pointées par le paramètre pClientInterfaceInfo . Si l’application appelante spécifie NULL pour pClientInterfaceInfo, l’application appelante doit spécifier zéro pour ce paramètre.

[in, optional] lpwsDLLPath

Pointeur vers une chaîne Unicode terminée par null qui spécifie le nom de la DLL du gestionnaire de routeur pour le transport spécifié. Si ce nom est spécifié, la fonction définit le chemin d’accès DLL pour ce transport sur ce nom.

Ce paramètre est facultatif ; l’application appelante peut spécifier NULL pour ce paramètre.

[out] phRouterTransport

Pointeur vers un
VARIABLE HANDLE qui reçoit le type de handle de configuration de transport indiqué dans le paramètre dwTransportId .

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_INVALID_PARAMETER	Le paramètre hMprConfig est NULL, ou le paramètre phRouterTransport a la valeur NULL, ou les deux sont NULL.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.
Autres	Utilisez FormatMessage pour récupérer le message d’erreur système qui correspond au code d’erreur retourné.

Notes

Si le transport spécifié existe déjà, MprConfigTransportCreate effectue l’équivalent d’un appel MprConfigTransportSetInfo à l’aide des valeurs de paramètre fournies.

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

FormatMessage

MprConfigServerConnect

Fonctions de configuration du routeur

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

Partager via