共用方式為

MprAdminUserSetInfo 函式 (mprapi.h)

  • 發行項

MprAdminUserSetInfo函式會設定指定使用者的 RAS 資訊。

語法

DWORD MprAdminUserSetInfo(
  [in] LPCWSTR      lpszServer,
  [in] LPCWSTR      lpszUser,
  [in] DWORD        dwLevel,
  [in] const LPBYTE lpbBuffer
);

參數

[in] lpszServer

Unicode 字串的指標，指定具有主要使用者帳戶子系統 (UAS) 的伺服器名稱。 如果遠端存取服務器是網域的一部分，則具有 UAS 的電腦是主要網域控制站或備份網域控制站。 如果遠端存取服務器不是網域的一部分，則伺服器本身會儲存 UAS。 在任一情況下，呼叫 MprAdminGetPDCServer 函式以取得此參數的值。

如果伺服器本身儲存 UAS，此參數可以是 Null。

[in] lpszUser

Unicode 字串的指標，指定要設定 RAS 資訊的使用者名稱。

[in] dwLevel

此參數可以是零或一個，對應至 lpbBuffer 參數所指向的結構類型。

Windows NT Server 4.0 SP3 和更新版本： 此參數必須是零。

[in] lpbBuffer

指定使用者新 RAS 資訊的 RAS_USER_0 或 RAS_USER_1 結構的指標。

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

傳回值

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

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

值 意義
ERROR_ACCESS_DENIED
 呼叫端沒有足夠的許可權。
錯誤_INVALID_LEVEL
 dwLevel的值無效。
ERROR_NOT_ENOUGH_MEMORY
 資源不足，無法完成作業。
ERROR_NO_SUCH_USER
 lpwsUserName指定的使用者不存在於lpwsServerName所指定的伺服器上。

備註

如果已安裝 RRAS 可轉散發套件，此函式可在 Windows NT 4.0 上使用。 不過，隨附 RRAS 可轉散發套件的 Mprapi.dll 版本會將函式匯出為 RasAdminUserSetInfo ，而不是 MprAdminUserSetInfo。 因此，使用 RRAS 可轉散發套件時，請使用 LoadLibrary 和 GetProcAddress 來存取此函式。

需求

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

另請參閱

MprAdminGetPDCServer

MprAdminUserGetInfo

RAS 系統管理功能

RAS_USER_0

遠端存取服務管理參考