MprConfigInterfaceTransportGetHandle, fonction (mprapi.h)

Article
03/04/2024

La fonction MprConfigInterfaceTransportGetHandle récupère un handle pour la configuration de transport d’une interface dans la configuration de routeur spécifiée.

Syntaxe

DWORD MprConfigInterfaceTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  HANDLE hRouterInterface,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterIfTransport
);

Paramètres

[in] hMprConfig

Gérez la configuration du routeur. Obtenez ce handle en appelant MprConfigServerConnect.

[in] hRouterInterface

Gérez la configuration de l’interface. Obtenez ce handle en appelant MprConfigInterfaceCreate, MprConfigInterfaceGetHandle ou MprConfigInterfaceEnum.

[in] dwTransportId

Valeur DWORD qui décrit le type de handle de configuration de transport dans le paramètre phRouterIfTransport . 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] phRouterIfTransport

Pointeur vers un
VARIABLE HANDLE qui reçoit le type de handle de configuration de transport pour cette interface 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	Au moins un des éléments suivants est vrai : hMprConfig a la valeur NULL. hRouterInterface a la valeur NULL. phRouterIfTransport a la valeur NULL.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.
ERROR_NO_SUCH_INTERFACE	L’interface spécifiée par hRouterInterface n’a pas été trouvée dans la configuration du routeur, ou le transport spécifié par dwTransportId n’a pas été activé sur l’interface spécifiée.
Autres	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