Partager via


MprAdminServerGetInfo, fonction (mprapi.h)

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

Voir aussi

MPR_SERVER_0

MPR_SERVER_1

MPR_SERVER_2

MprAdminBufferFree

MprAdminServerConnect

MprAdminServerSetInfo

Fonctions d’administration du routeur

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