MprConfigTransportCreate, fonction (mprapi.h)
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 |
|---|---|
|
Le paramètre hMprConfig est NULL, ou le paramètre phRouterTransport a la valeur NULL, ou les deux sont NULL. |
|
Ressources insuffisantes pour terminer l’opération. |
|
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 |