mprAdminGetPDCServer 函式 (mprapi.h)

發行項
02/29/2024

MprAdminGetPDCServer 函式會從功能變數名稱或伺服器名稱擷取具有主要用戶帳戶子系統的伺服器名稱 (UAS) 。功能變數名稱參數或伺服器名稱參數可以是 NULL，但不能同時是兩者。

語法

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

參數

[in] lpszDomain

Null 終止 Unicode 字串的指標，指定 RAS 伺服器所屬的網域名稱。如果您在未參與網域的 Windows NT/Windows 2000 伺服器上執行 RAS 系統管理應用程式，此參數可以是 NULL。如果此參數為 NULL， 則 lpwsServerName 參數不得為 NULL。

[in] lpszServer

指定 Windows NT/Windows 2000 RAS 伺服器名稱的 Null 終止 Unicode 字串指標。以下列格式指定具有前置「\」字元的名稱： \servername。如果 lpwsDomain 參數不是 NULL，這個參數可以是 NULL。

[out] lpszPDCServer

緩衝區的指標，該緩衝區會接收以 Null 終止的 Unicode 字串，其中包含具有使用者帳戶資料庫的域控制器名稱。緩衝區應該夠大，以容納 UNCLEN +1 (伺服器名稱) 。函式會在傳回的伺服器名稱前面加上前置「\」字元，格式為 ：\servername。

傳回值

如果函式成功，傳回值會 NO_ERROR。

如果函式失敗，傳回值就是下列其中一個值。

值	意義
ERROR_NO_SUCH_DOMAIN	指定的網域無效。
NERR_InvalidComputer	lpwsDomainName 參數為 NULL，而 lpwsServerName 參數無效。

備註

MprAdminGetPDCServer 函式可以使用指定 RAS 伺服器名稱的使用者帳戶資料庫，或是 RAS 伺服器所在的網域名稱，取得伺服器的名稱。若要取得伺服器名稱，請呼叫 GetComputerName 函式

如果 lpszServer 指定的伺服器名稱是網域的一部分， MprAdminGetPDCServer 傳回的伺服器將會是主要域控制器或備份域控制器。

如果 lpszServer 指定的伺服器名稱是獨立 Windows NT/Windows 2000 伺服器 (，則伺服器或工作站不會參與網域) ，則會在 lpszUserAccountServer 緩衝區中傳回伺服器名稱本身。

然後，您可以在對 NetQueryDisplayInformation 函式的呼叫中使用使用者帳戶伺服器的名稱，以列舉用戶帳戶資料庫中的使用者。您也可以使用呼叫 MprAdminUserGetInfo 和 MprAdminUserSetInfo 函式的伺服器名稱，來取得和設定指定使用者帳戶的 RAS 許可權。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	mprapi.h
程式庫	Mprapi.lib
Dll	Mprapi.dll