MprConfigInterfaceGetHandle, fonction (mprapi.h)

Article
03/04/2024

La fonction MprConfigInterfaceGetHandle récupère un handle pour la configuration de l’interface spécifiée dans la configuration de routeur spécifiée.

Syntaxe

DWORD MprConfigInterfaceGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  LPWSTR lpwsInterfaceName,
  [out] HANDLE *phRouterInterface
);

Paramètres

[in] hMprConfig

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

[in] lpwsInterfaceName

Pointeur vers une chaîne Unicode terminée par un caractère Null qui spécifie le nom de l’interface pour laquelle le handle de configuration est demandé. Utilisez le GUID d’interface comme nom d’une interface LAN.

[out] phRouterInterface

Pointeur vers une variable de handle. Cette variable reçoit un handle pour la configuration de l’interface.

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 lpwsInterfaceName est NULL, ou les deux paramètres sont NULL.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.
ERROR_NO_SUCH_INTERFACE	L’interface spécifiée est introuvable dans la configuration du routeur.
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

Voir aussi

FormatMessage

MprConfigServerConnect

Fonctions de configuration du routeur

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

Partager via