Fonction MprConfigServerGetInfo (mprapi.h)

Article
02/29/2024

La fonction MprConfigServerGetInfo récupère les informations de configuration au niveau du serveur pour le routeur spécifié.

Syntaxe

DWORD MprConfigServerGetInfo(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [out] LPBYTE *lplpbBuffer
);

Paramètres

[in] hMprConfig

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

[in] dwLevel

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

Valeur	Structure Format
0	Windows 2000 Server ou version ultérieure : MPR_SERVER_0
1	Windows Server 2003 ou version ultérieure : MPR_SERVER_1
2	Windows Server 2008 ou version ultérieure : MPR_SERVER_2

[out] lplpbBuffer

Une fois la saisie terminée, un pointeur vers un MPR_SERVER_0, MPR_SERVER_1,
ou MPR_SERVER_2 structure. Le paramètre dwLevel indique le type de structure. Libérez la mémoire pour cette mémoire tampon à l’aide de MprConfigBufferFree.

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 : Le paramètre hMprConfig a la valeur NULL. Le paramètre dwLevel n’est pas égal à zéro. Le paramètre lplpBuffer est NULL.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.
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