Freigeben über


MprAdminGetPDCServer-Funktion (mprapi.h)

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

Weitere Informationen

GetComputerName

MprAdminUserGetInfo

MprAdminUserSetInfo

NetQueryDisplayInformation

RAS-Verwaltungsfunktionen

Referenz zur Remotezugriffsdienstverwaltung