共用方式為


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_0RAS_USER_1 結構的指標。 呼叫端必須配置 (並釋放此結構的記憶體) 。 成功傳回時,這個結構會包含指定使用者的 RAS 數據。

Windows NT Server 4.0 SP3 和更新版本:如果 dwLevel 參數指定零,lpbBuffer 應該指向RAS_USER_0結構。

傳回值

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

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

意義
ERROR_ACCESS_DENIED
呼叫端沒有足夠的許可權。
ERROR_INVALID_LEVEL
dwLevel 的值無效。
ERROR_INVALID_PARAMETER
lpbBufferNULL
ERROR_NO_SUCH_USER
由 lpwsUserName 指定的使用者不存在於 lpwsServerName 所指定的伺服器上。

備註

如果已安裝 RRAS 可轉散發套件,此函式可在 Windows NT 4.0 上使用。 不過,RRAS 可轉散發套件隨附的 Mprapi.dll 版本會將函式導出為 RasAdminUserGetInfo ,而不是 MprAdminUserGetInfo。 因此,使用 RRAS 可轉散發套件時,請使用 LoadLibraryGetProcAddress 來存取此函式。

規格需求

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

另請參閱

MprAdminGetPDCServer

MprAdminUserSetInfo

RAS 管理功能

RAS_USER_0

遠端訪問服務管理參考