Funzione MprAdminConnectionGetInfo (mprapi.h)

Articolo
02/29/2024

La funzione MprAdminConnectionGetInfo recupera i dati relativi a una connessione specifica.

Sintassi

DWORD MprAdminConnectionGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hRasConnection,
  [out] LPBYTE            *lplpbBuffer
);

Parametri

[in] hRasServer

Handle per il computer da cui vengono recuperate le informazioni di connessione. Per ottenere questo handle, chiamare MprAdminServerConnect.

[in] dwLevel

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

Windows NT 4.0: Questo parametro deve essere zero.

Valore	Formato struttura
0	RAS_CONNECTION_0
1	Windows 2000 o versioni successive: RAS_CONNECTION_1
2	Windows 2000 o versioni successive: RAS_CONNECTION_2
3	Windows Server 2008 o versione successiva: RAS_CONNECTION_3

[in] hRasConnection

Handle per la connessione per recuperare i dati. Per ottenere questo handle, chiamare MprAdminConnectionEnum.

[out] lplpbBuffer

Al termine, un puntatore a una matrice di strutture che descrivono la connessione. Queste strutture sono di tipo RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2 o RAS_CONNECTION_3, a seconda del valore del parametro dwLevel .

Per liberare questa memoria, chiama 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 elencati nella tabella seguente.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	L'handle per il server RAS o l'handle per la connessione RAS non è valido.
ERROR_INVALID_LEVEL	Il valore passato per dwLevel non è zero, uno, due o tre. I livelli uno e due sono supportati solo in Windows 2000 o versioni successive. Il livello 3 è supportato solo in Windows Server 2008 o versione successiva.
ERROR_INTERFACE_NOT_CONNECTED	L'handle hConnection non è valido.
RPC_S_INVALID_BINDING	L'handle hRasServer non è valido.
Altri	Errore da MprError.h, RasError.h o WinError.h.

Commenti

Questa funzione è disponibile in Windows NT 4.0 se è installato RRAS redistributable. Tuttavia, la versione di Mprapi.dll inclusa in RRAS redistributable esporta la funzione come RasAdminConnectionGetInfo anziché MprAdminConnectionGetInfo. Pertanto, quando si usa RRAS redistributable, usare LoadLibrary e GetProcAddress per accedere a questa funzione.

Requisiti

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