Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La fonction MprAdminInterfaceSetInfo définit des informations pour une interface spécifiée sur un serveur spécifié.
Syntaxe
DWORD MprAdminInterfaceSetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwLevel,
[in] LPBYTE lpbBuffer
);
Paramètres
[in] hMprServer
Gérez le routeur à interroger. Ce handle est obtenu à partir d’un appel précédent à MprAdminServerConnect.
[in] hInterface
Gérez l’interface obtenue par un appel précédent à MprAdminInterfaceCreate.
[in] dwLevel
Valeur DWORD qui décrit le format dans lequel les informations sont structurées dans le paramètre lpbBuffer . Les valeurs acceptables pour dwLevel incluent 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.
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 |
|---|---|
|
L’application appelante ne dispose pas de privilèges suffisants. |
|
La valeur hInterface n’est pas valide. |
|
Le paramètre lplpbBuffer est NULL. |
|
Ressources insuffisantes pour terminer l’opération. |
|
La valeur dwLevel n’est pas valide. |
Remarques
La fonction MprAdminInterfaceSetInfo prend en charge la structure MPR_INTERFACE_2 . Toutefois, MprConfigInterfaceSetInfo ne le fait pas. Pour apporter des modifications persistantes à une interface de numérotation à la demande, appelez MprAdminInterfaceSetInfo avec MPR_INTERFACE_2, puis appelez MprConfigInterfaceSetInfo avec MPR_INTERFACE_0 ou MPR_INTERFACE_1.
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 |