Fonction MprConfigTransportGetHandle (mprapi.h)
La fonction MprConfigTransportGetHandle récupère un handle pour la configuration du protocole de transport spécifié dans la configuration de routeur spécifiée.
Syntaxe
DWORD MprConfigTransportGetHandle(
[in] HANDLE hMprConfig,
[in] DWORD dwTransportId,
[out] HANDLE *phRouterTransport
);
Paramètres
[in] hMprConfig
Gérez la configuration du routeur. Le handle est obtenu à partir d’un appel précédent à MprConfigServerConnect.
[in] dwTransportId
Valeur DWORD qui décrit le type de handle de configuration de transport dans le paramètre phRouterTransport . 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 |
[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 et/ou le paramètre phRouterTransport est NULL. |
|
Ressources insuffisantes pour terminer l’opération. |
|
Le protocole de transport spécifié par dwTransportId est introuvable dans la configuration du routeur. |
|
Utilisez FormatMessage pour récupérer le message d’erreur système qui correspond au code d’erreur retourné. |
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 |