MprAdminUserGetInfo-Funktion (mprapi.h)
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 |
|---|---|
|
Der Aufrufer verfügt nicht über ausreichende Berechtigungen. |
|
Der Wert von dwLevel ist ungültig. |
|
lpbBuffer ist NULL. |
|
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 |