MprAdminGetPDCServer-Funktion (mprapi.h)

Artikel
02/29/2024

Die Funktion MprAdminGetPDCServer ruft den Namen des Servers mit dem master Benutzerkontensubsystem (UAS) aus einem Domänennamen oder einem Servernamen ab. Entweder der Domänenname-Parameter oder der Servername-Parameter kann NULL, aber nicht beides sein.

Syntax

DWORD MprAdminGetPDCServer(
  [in]  LPCWSTR lpszDomain,
  [in]  LPCWSTR lpszServer,
  [out] LPWSTR  lpszPDCServer
);

Parameter

[in] lpszDomain

Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen der Domäne angibt, zu der der RAS-Server gehört. Dieser Parameter kann NULL sein, wenn Sie Ihre RAS-Verwaltungsanwendung auf einem Windows NT/Windows 2000-Server ausführen, der nicht an einer Domäne teilnimmt. Wenn dieser Parameter NULL ist, darf der lpwsServerName-Parameter nicht NULL sein.

[in] lpszServer

Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen des Windows NT/Windows 2000 RAS-Servers angibt. Geben Sie den Namen mit den führenden Zeichen "\" im Format \servername an. Dieser Parameter kann NULL sein, wenn der lpwsDomain-Parameter nicht NULL ist.

[out] lpszPDCServer

Zeiger auf einen Puffer, der eine Unicode-Zeichenfolge mit NULL-Beendigung empfängt, die den Namen eines Domänencontrollers enthält, 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 NO_ERROR.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert einer der folgenden Werte.

Wert	Bedeutung
ERROR_NO_SUCH_DOMAIN	Die angegebene Domäne ist ungültig.
NERR_InvalidComputer	Der Parameter lpwsDomainName ist NULL, und der Parameter lpwsServerName ist ungültig.

Hinweise

Die Funktion MprAdminGetPDCServer kann den Namen des Servers mit der Benutzerkontendatenbank abrufen, wobei der Name des RAS-Servers oder der Name der Domäne angegeben ist, in der sich der RAS-Server befindet. Um den Servernamen abzurufen, rufen Sie die GetComputerName-Funktion auf.

Wenn der von lpszServer angegebene Servername Teil einer Domäne ist, ist der von MprAdminGetPDCServer zurückgegebene Server entweder der primäre Domänencontroller oder ein Sicherungsdomänencontroller.

Wenn der von lpszServer angegebene Servername ein eigenständiger Windows NT/Windows 2000-Server ist (d. h. der Server oder die Arbeitsstation ist nicht an einer Domäne beteiligt), wird der Servername selbst im Puffer lpszUserAccountServer zurückgegeben.

Anschließend können Sie den Namen des Benutzerkontoservers in einem Aufruf der NetQueryDisplayInformation-Funktion verwenden, um die Benutzer in der Benutzerkontodatenbank aufzulisten. Sie können den Servernamen auch in Aufrufen der Funktionen MprAdminUserGetInfo und MprAdminUserSetInfo verwenden, um RAS-Berechtigungen für ein angegebenes Benutzerkonto abzurufen und festzulegen.

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