MprAdminServerGetInfo, fonction (mprapi.h)

Article
02/29/2024

La fonction MprAdminServerGetInfo récupère des informations sur le serveur RRAS spécifié.

Syntaxe

DWORD MprAdminServerGetInfo(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Paramètres

[in] hMprServer

Gérez vers le routeur à interroger. Obtenez ce handle en appelant MprAdminServerConnect.

[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

En cas d’achèvement réussi, pointeur vers un MPR_SERVER_0 , MPR_SERVER_1,
ou MPR_SERVER_2 structure. Le paramètre dwLevel indique le type de structure. Libérer la mémoire de cette mémoire tampon à l’aide de MprAdminBufferFree

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_INVALID_PARAMETER	Le paramètre lplpbBuffer est NULL.
RPC_S_INVALID_BINDING	Le paramètre hMprServer est NULL.

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