RasAdminGetUserAccountServer 函式

[此函式僅針對與 Windows NT Server 4.0 的回溯相容性提供。 它會在 Windows Server 2003 上傳回ERROR_CALL_NOT_IMPLEMENTED。 應用程式應該使用 MprAdminGetPDCServer 函 式。]

RasAdminGetUserAccountServer函式會擷取具有使用者帳戶資料庫的伺服器名稱。 在 RasAdminUserGetInfo 和 RasAdminUserSetInfo 函式中使用傳回的伺服器名稱，以取得或設定指定使用者的相關資訊。

語法

DWORD RasAdminGetUserAccountServer(
  _In_  const WCHAR  *lpszDomain,
  _In_  const WCHAR  *lpszServer,
  _Out_       LPWSTR lpszUserAccountServer
);

參數

lpszDomain [in]

Null終止 Unicode 字串的指標，指定 RAS 伺服器所屬的網功能變數名稱稱。 在不是網域成員的工作站或伺服器上執行的 RAS 管理應用程式，此參數為 Null 。 如果此參數為 Null， 則 lpszServer 參數必須是非Null。

lpszServer [in]

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

lpszUserAccountServer [out]

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

傳回值

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

如果函式失敗，傳回值可以是下列錯誤碼。

值	意義
ERROR_INVALID_PARAMETER	lpszDomain和lpszServer都是Null。

此函式沒有擴充的錯誤資訊;請勿呼叫 GetLastError。

備註

RasAdminGetUserAccountServer函式會取得具有使用者帳戶資料庫的伺服器名稱。 此函式需要 RAS 伺服器的名稱或 RAS 伺服器所在的網功能變數名稱稱。

lpszDomain參數應該指定有效的功能變數名稱。 例如，在不是網域成員 (的伺服器上執行的 RAS 管理應用程式，此參數為 Null ，例如，伺服器位於自己的工作組) 。 在此情況下， lpszServer 參數必須指定伺服器名稱。 若要取得伺服器名稱，請呼叫 GetComputerName 函式。 請務必在伺服器名稱前面加上 「\\」 字元。

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

然後使用 NetQueryDisplayInformation 函式呼叫中的使用者帳戶伺服器名稱，列舉使用者帳戶資料庫中的使用者。

規格需求

需求	值
用戶端支援結束	Windows 2000 Professional
伺服器終止支援	Windows 2000 Server
標頭	Rassapi.h
程式庫	Rassapi.lib
DLL	Rassapi.dll

另請參閱

遠端存取服務 (RAS) 概觀

RAS 伺服器管理功能

GetComputerName

RasAdminUserGetInfo

RasAdminUserSetInfo