Funzione MprAdminServerGetInfo (mprapi.h)

Articolo
03/13/2024

La funzione MprAdminServerGetInfo recupera informazioni sul server RRAS specificato.

Sintassi

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

Parametri

[in] hMprServer

Gestire il router su cui eseguire una query. Ottenere questo handle chiamando MprAdminServerConnect.

[in] dwLevel

Valore DWORD che descrive il formato in cui vengono restituite le informazioni nel parametro lplpBuffer . I valori accettabili per dwLevel includono 0, 1 e 2 come indicato nella tabella seguente.

Valore	Formato struttura
0	Windows 2000 Server o versioni successive: MPR_SERVER_0
1	Windows Server 2003 o versione successiva: MPR_SERVER_1
2	Windows Server 2008 o versioni successive: MPR_SERVER_2

[out] lplpbBuffer

Al termine, un puntatore a un MPR_SERVER_0, MPR_SERVER_1,
o MPR_SERVER_2 struttura. Il parametro dwLevel indica il tipo di struttura. Liberare la memoria per questo buffer usando MprAdminBufferFree

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_INVALID_PARAMETER	Il parametro lplpbBuffer è NULL.
RPC_S_INVALID_BINDING	Il parametro hMprServer è NULL.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll