mprAdminUserGetInfo 函式 (mprapi.h)
MprAdminUserGetInfo 函式會擷取特定使用者的所有 RAS 資訊。
語法
DWORD MprAdminUserGetInfo(
[in] LPCWSTR lpszServer,
[in] LPCWSTR lpszUser,
[in] DWORD dwLevel,
[out] LPBYTE lpbBuffer
);
參數
[in] lpszServer
Unicode 字串的指標,指定具有主要使用者帳戶子系統 (UAS) 的伺服器名稱。 如果遠端存取伺服器是網域的一部分,則具有 UAS 的電腦是主要域控制器或備份域控制器。 如果遠端存取伺服器不是網域的一部分,則伺服器本身會儲存 UAS。 不論是哪一種情況,呼叫 MprAdminGetPDCServer 函 式以取得此參數的值。
如果伺服器本身儲存 UAS,此參數可以是 NULL。
[in] lpszUser
Unicode 字串的指標,指定要取得 RAS 資訊的用戶名稱。
[in] dwLevel
此參數可以是零或一。
Windows NT Server 4.0 SP3 和更新版本:此參數必須為零。
[out] lpbBuffer
RAS_USER_0或RAS_USER_1 結構的指標。 呼叫端必須配置 (並釋放此結構的記憶體) 。 成功傳回時,這個結構會包含指定使用者的 RAS 數據。
Windows NT Server 4.0 SP3 和更新版本:如果 dwLevel 參數指定零,lpbBuffer 應該指向RAS_USER_0結構。
傳回值
如果函式成功,傳回值會NO_ERROR。
如果函式失敗,傳回值就是下列其中一個值。
值 | 意義 |
---|---|
|
呼叫端沒有足夠的許可權。 |
|
dwLevel 的值無效。 |
|
lpbBuffer 為 NULL |
|
由 lpwsUserName 指定的使用者不存在於 lpwsServerName 所指定的伺服器上。 |
備註
如果已安裝 RRAS 可轉散發套件,此函式可在 Windows NT 4.0 上使用。 不過,RRAS 可轉散發套件隨附的 Mprapi.dll 版本會將函式導出為 RasAdminUserGetInfo ,而不是 MprAdminUserGetInfo。 因此,使用 RRAS 可轉散發套件時,請使用 LoadLibrary 和 GetProcAddress 來存取此函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | mprapi.h |
程式庫 | Mprapi.lib |
Dll | Mprapi.dll |