RasAdminGetUserAccountServer-Funktion
[Diese Funktion wird nur für die Abwärtskompatibilität mit Windows NT Server 4.0 bereitgestellt. Es gibt ERROR_CALL_NOT_IMPLEMENTED unter Windows Server 2003 zurück. Anwendungen sollten die Funktion MprAdminGetPDCServer verwenden.]
Die RasAdminGetUserAccountServer-Funktion ruft den Namen des Servers ab, der über die Benutzerkontodatenbank verfügt. Verwenden Sie den zurückgegebenen Servernamen in den Funktionen RasAdminUserGetInfo und RasAdminUserSetInfo , um Informationen zu einem angegebenen Benutzer abzurufen oder festzulegen.
Syntax
DWORD RasAdminGetUserAccountServer(
_In_ const WCHAR *lpszDomain,
_In_ const WCHAR *lpszServer,
_Out_ LPWSTR lpszUserAccountServer
);
Parameter
-
lpszDomain [in]
-
Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen der Domäne angibt, zu der der RAS-Server gehört. Dieser Parameter ist NULL für die RAS-Verwaltungsanwendungen, die auf Arbeitsstationen oder Servern ausgeführt werden, die keine Mitglieder einer Domäne sind. Wenn dieser Parameter NULL ist, muss der lpszServer-Parameter nicht NULL sein.
-
lpszServer [in]
-
Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen des RAS-Servers angibt. Geben Sie den Namen mit den führenden Zeichen "\\" im Format \\servername an. Dieser Parameter kann NULL sein, wenn der lpszDomain-Parameter nicht NULL ist.
-
lpszUserAccountServer [out]
-
Zeiger auf einen Puffer, der eine Unicode-Zeichenfolge mit NULL-Beendigung empfängt, die den Namen eines Domänencontrollers angibt, der über die Benutzerkontodatenbank verfügt. Der Puffer sollte groß genug sein, um den Servernamen (UNCLEN +1) aufzunehmen. Die Funktion präfixiert den zurückgegebenen Servernamen mit führenden Zeichen "\\" in der Form : \\servername.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, kann der Rückgabewert der folgende Fehlercode sein.
| Wert | Bedeutung |
|---|---|
|
Sowohl lpszDomain als auch lpszServer sind NULL. |
Es gibt keine erweiterten Fehlerinformationen für diese Funktion. Rufen Sie GetLastError nicht auf.
Bemerkungen
Die RasAdminGetUserAccountServer-Funktion ruft den Namen des Servers mit der Benutzerkontendatenbank ab. Diese Funktion erfordert den Namen des RAS-Servers oder den Namen der Domäne, in der sich der RAS-Server befindet.
Der lpszDomain-Parameter sollte einen gültigen Domänennamen angeben. Dieser Parameter ist NULL für RAS-Verwaltungsanwendungen, die auf Servern ausgeführt werden, die keine Mitglieder einer Domäne sind (z. B. befindet sich der Server in einer eigenen Arbeitsgruppe). In diesem Fall muss der lpszServer-Parameter den Servernamen angeben. Um den Servernamen abzurufen, rufen Sie die GetComputerName-Funktion auf. Stellen Sie sicher, dass Dem Servernamen die Zeichen "\\" vorangestellt werden.
Wenn der von lpszServer angegebene Servername ein eigenständiger Server ist (d. h. der Server oder die Arbeitsstation ist kein Mitglied einer Domäne), wird der Servername selbst im Puffer lpszUserAccountServer zurückgegeben.
Verwenden Sie dann den Namen des Benutzerkontoservers in einem Aufruf der NetQueryDisplayInformation-Funktion , um die Benutzer in der Benutzerkontodatenbank aufzulisten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports (Client) |
Windows 2000 Professional |
| Ende des Supports (Server) |
Windows 2000 Server |
| Header |
|
| Bibliothek |
|
| DLL |
|