MprAdminUserSetInfo 関数 (mprapi.h)

  • [アーティクル]

MprAdminUserSetInfo 関数は、指定したユーザーの RAS 情報を設定します。

構文

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

パラメーター

[in] lpszServer

マスター ユーザー アカウント サブシステム (UAS) を持つサーバーの名前を指定する Unicode 文字列へのポインター。 リモート アクセス サーバーがドメインの一部である場合、UAS を持つコンピューターはプライマリ ドメイン コントローラーまたはバックアップ ドメイン コントローラーのいずれかになります。 リモート アクセス サーバーがドメインの一部でない場合、サーバー自体は UAS を格納します。 どちらの場合も、 MprAdminGetPDCServer 関数を呼び出して、このパラメーターの値を取得します。

サーバー自体に UAS が格納されている場合、このパラメーターは NULL にすることができます。

[in] lpszUser

RAS 情報を設定するユーザーの名前を指定する Unicode 文字列へのポインター。

[in] dwLevel

このパラメーターには、 lpbBuffer パラメーターが指す構造体の型に対応する 0 または 1 を指定できます。

WINDOWS NT Server 4.0 SP3 以降: このパラメーターは 0 である必要があります。

[in] lpbBuffer

ユーザー の新 しい RAS 情報を指定する RAS_USER_0またはRAS_USER_1 構造体へのポインター。

WINDOWS NT Server 4.0 SP3 以降: dwLevel パラメーターで 0 が指定されている場合、lpbBuffer はRAS_USER_0構造体を指す必要があります。

戻り値

関数が成功した場合、戻り値は NO_ERROR。

関数が失敗した場合、戻り値は次のいずれかの値になります。

値 説明
ERROR_ACCESS_DENIED
 呼び出し元に十分な特権がありません。
ERROR _INVALID_LEVEL
 dwLevel の値が無効です。
ERROR_NOT_ENOUGH_MEMORY
 操作を完了するためのリソースが不足しています。
ERROR_NO_SUCH_USER
 lpwsUserName で指定されたユーザーが、lpwsServerName で指定されたサーバーに存在しません。

解説

この関数は、RRAS 再頒布可能パッケージがインストールされている場合、Windows NT 4.0 で使用できます。 ただし、RRAS 再頒布可能パッケージに付属する Mprapi.dll のバージョンでは、MprAdminUserSetInfo ではなく RasAdminUserSetInfo として関数がエクスポートされます。 したがって、RRAS 再頒布可能パッケージを使用する場合は、 LoadLibrary と GetProcAddress を 使用してこの関数にアクセスします。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mprapi.h
Library Mprapi.lib
[DLL] Mprapi.dll

関連項目

MprAdminGetPDCServer

MprAdminUserGetInfo

RAS 管理関数

RAS_USER_0

リモート アクセス サービス管理リファレンス