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。
如果函式失敗,傳回值可以是下列錯誤碼。
值 | 意義 |
---|---|
|
lpszDomain和lpszServer都是Null。 |
此函式沒有擴充的錯誤資訊;請勿呼叫 GetLastError。
備註
RasAdminGetUserAccountServer函式會取得具有使用者帳戶資料庫的伺服器名稱。 此函式需要 RAS 伺服器的名稱或 RAS 伺服器所在的網功能變數名稱稱。
lpszDomain參數應該指定有效的功能變數名稱。 例如,在不是網域成員 (的伺服器上執行的 RAS 管理應用程式,此參數為 Null ,例如,伺服器位於自己的工作組) 。 在此情況下, lpszServer 參數必須指定伺服器名稱。 若要取得伺服器名稱,請呼叫 GetComputerName 函式。 請務必在伺服器名稱前面加上 「\\」 字元。
如果 lpszServer 指定的伺服器名稱是獨立伺服器 (,則伺服器或工作站不是網域) 的成員,則會在 lpszUserAccountServer 緩衝區中傳回伺服器名稱本身。
然後使用 NetQueryDisplayInformation 函式呼叫中的使用者帳戶伺服器名稱,列舉使用者帳戶資料庫中的使用者。
規格需求
需求 | 值 |
---|---|
用戶端支援結束 |
Windows 2000 Professional |
伺服器終止支援 |
Windows 2000 Server |
標頭 |
|
程式庫 |
|
DLL |
|