MprAdminUserSetInfo-Funktion (mprapi.h)

Artikel
08/24/2023

Die Funktion MprAdminUserSetInfo legt RAS-Informationen für den angegebenen Benutzer fest.

Syntax

DWORD MprAdminUserSetInfo(
  [in] LPCWSTR      lpszServer,
  [in] LPCWSTR      lpszUser,
  [in] DWORD        dwLevel,
  [in] const 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 festgelegt werden sollen.

[in] dwLevel

Dieser Parameter kann null oder 1 sein, was dem Strukturtyp entspricht, auf den der lpbBuffer-Parameter verweist.

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

[in] lpbBuffer

Zeiger auf eine RAS_USER_0- oder RAS_USER_1-Struktur , die die neuen RAS-Informationen für den Benutzer angibt.

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.
FEHLER _INVALID_LEVEL	Der Wert von dwLevel ist ungültig.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen zum Abschließen des Vorgangs.
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 der RRAS-Verteilerfunktion ausgeliefert wird, exportiert die Funktion jedoch als RasAdminUserSetInfo anstelle von MprAdminUserSetInfo. Wenn Sie RRAS redistributable verwenden, verwenden Sie daher LoadLibrary und GetProcAddress , um auf diese Funktion zuzugreifen.

Anforderungen


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