MprAdminUserGetInfo-Funktion (mprapi.h)

Artikel
08/24/2023

Die Funktion MprAdminUserGetInfo ruft alle RAS-Informationen für einen bestimmten Benutzer ab.

Syntax

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

Parameter

[in] lpszServer

Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Servers mit dem master Benutzerkonten-Subsystem (UAS) angibt. Wenn der RAS-Server Teil einer Domäne ist, ist der Computer mit der UAS entweder der primäre Domänencontroller oder der Sicherungsdomänencontroller. Wenn der RAS-Server nicht Teil einer Domäne ist, speichert der Server selbst die UAS. Rufen Sie in beiden Fällen die Funktion MprAdminGetPDCServer auf, um den Wert für diesen Parameter zu erhalten.

Wenn der Server selbst die UAS speichert, kann dieser Parameter NULL sein.

[in] lpszUser

Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Benutzers angibt, für den RAS-Informationen abgerufen werden sollen.

[in] dwLevel

Dieser Parameter kann null oder 1 sein.

Windows NT Server 4.0 mit SP3 und höher: Dieser Parameter muss null sein.

[out] lpbBuffer

Zeiger auf eine RAS_USER_0- oder RAS_USER_1-Struktur . Der Aufrufer muss den Arbeitsspeicher für diese Struktur zuordnen (und freigeben). Nach erfolgreicher Rückgabe enthält diese Struktur die RAS-Daten für den angegebenen Benutzer.

Windows NT Server 4.0 mit SP3 und höher: Wenn der dwLevel-Parameter null angibt, sollte lpbBuffer auf eine RAS_USER_0-Struktur verweisen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Werte.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Der Aufrufer verfügt nicht über ausreichende Berechtigungen.
ERROR_INVALID_LEVEL	Der Wert von dwLevel ist ungültig.
ERROR_INVALID_PARAMETER	lpbBuffer ist NULL.
ERROR_NO_SUCH_USER	Der durch lpwsUserName angegebene Benutzer ist auf dem server, der von lpwsServerName angegeben wird, nicht vorhanden.

Hinweise

Diese Funktion ist unter Windows NT 4.0 verfügbar, wenn RRAS redistributable installiert ist. Die Version von Mprapi.dll, die mit RRAS redistributable enthalten ist, exportiert die Funktion jedoch als RasAdminUserGetInfo anstelle von MprAdminUserGetInfo. Wenn Sie RRAS redistributable verwenden, verwenden Sie daher LoadLibrary und GetProcAddress , um auf diese Funktion zuzugreifen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h
Bibliothek	Mprapi.lib
DLL	Mprapi.dll