Funzione MprAdminUserGetInfo (mprapi.h)

Articolo
03/15/2023

La funzione MprAdminUserGetInfo recupera tutte le informazioni RAS per un determinato utente.

Sintassi

DWORD MprAdminUserGetInfo(
  [in]  LPCWSTR lpszServer,
  [in]  LPCWSTR lpszUser,
  [in]  DWORD   dwLevel,
  [out] LPBYTE  lpbBuffer
);

Parametri

[in] lpszServer

Puntatore a una stringa Unicode che specifica il nome del server con il sottosistema account utente master (UAS). Se il server di accesso remoto fa parte di un dominio, il computer con UAS è il controller di dominio primario o il controller di dominio di backup. Se il server di accesso remoto non fa parte di un dominio, il server stesso archivia l'UAS. In entrambi i casi, chiamare la funzione MprAdminGetPDCServer per ottenere il valore per questo parametro.

Se il server stesso archivia uAS, questo parametro può essere NULL.

[in] lpszUser

Puntatore a una stringa Unicode che specifica il nome dell'utente per cui ottenere informazioni RAS.

[in] dwLevel

Questo parametro può essere zero o uno.

Windows NT Server 4.0 con SP3 e versioni successive: Questo parametro deve essere zero.

[out] lpbBuffer

Puntatore a una struttura RAS_USER_0 o RAS_USER_1 . Il chiamante deve allocare (e liberare) la memoria per questa struttura. Al termine della restituzione, questa struttura contiene i dati RAS per l'utente specificato.

Windows NT Server 4.0 con SP3 e versioni successive: Se il parametro dwLevel specifica zero, lpbBuffer deve puntare a una struttura RAS_USER_0 .

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	Il chiamante non dispone di privilegi sufficienti.
ERROR_INVALID_LEVEL	Il valore di dwLevel non è valido.
ERROR_INVALID_PARAMETER	lpbBuffer è NULL
ERROR_NO_SUCH_USER	L'utente specificato da lpwsUserName non esiste nel server specificato da lpwsServerName.

Commenti

Questa funzione è disponibile in Windows NT 4.0 se la ridistribuibile RRAS è installata. Tuttavia, la versione di Mprapi.dll fornita con RRAS ridistribuibile esporta la funzione come RasAdminUserGetInfo anziché MprAdminUserGetInfo. Pertanto, quando si usa RRAS ridistribuibile, 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