MprAdminUserSetInfo-Funktion (mprapi.h)
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 |
|---|---|
|
Der Aufrufer verfügt nicht über ausreichende Berechtigungen. |
|
Der Wert von dwLevel ist ungültig. |
|
Unzureichende Ressourcen zum Abschließen des Vorgangs. |
|
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 |