MprAdminInterfaceCreate, fonction (mprapi.h)

Article
08/24/2023

La fonction MprAdminInterfaceCreate crée une interface sur un serveur spécifié.

Syntaxe

DWORD MprAdminInterfaceCreate(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [in]  LPBYTE            lpbBuffer,
  [out] HANDLE            *phInterface
);

Paramètres

[in] hMprServer

Gérez le routeur sur lequel exécuter cet appel. Obtenez ce handle en appelant MprAdminServerConnect.

[in] dwLevel

Valeur DWORD qui décrit le format dans lequel les informations sont structurées dans le paramètre lpBuffer . Les valeurs acceptables pour dwLevel sont 0, 1, 2 et 3, comme indiqué dans le tableau suivant.

Valeur	Structure Format
0	MPR_INTERFACE_0
1	MPR_INTERFACE_1
2	MPR_INTERFACE_2
3	Windows Server 2008 ou version ultérieure : MPR_INTERFACE_3

[in] lpbBuffer

Pointeur vers un MPR_INTERFACE_0 , MPR_INTERFACE_1,
MPR_INTERFACE_2 ou structure MPR_INTERFACE_3 . Le paramètre dwLevel indique le type de structure.

[out] phInterface

Pointeur vers une variable HANDLE . La variable reçoit un handle à utiliser dans tous les appels suivants pour gérer cette 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_ACCESS_DENIED	L’application appelante ne dispose pas de privilèges suffisants.
ERROR_DDM_NOT_RUNNING	Le type d’interface de routeur n’est pas pris en charge, car Dynamic Interface Manager est configuré pour s’exécuter uniquement sur un réseau local.
ERROR_INTERFACE_ALREADY_EXISTS	Une interface portant le même nom existe déjà.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.
ERROR_NOT_SUPPORTED	La valeur dwLevel n’est pas valide.

Notes

La fonction MprAdminInterfaceCreate prend en charge la structure MPR_INTERFACE_2 . Toutefois, MprConfigInterfaceCreate ne le fait pas. Pour créer une interface de numérotation à la demande persistante après un redémarrage, appelez MprAdminInterfaceCreate avec MPR_INTERFACE_2, puis appelez MprConfigInterfaceCreate avec MPR_INTERFACE_0 ou MPR_INTERFACE_1.

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