RasAdminUserSetInfo 関数

  • [アーティクル]

[この関数は、Windows NT Server 4.0 との下位互換性のみを目的として提供されます。 Windows Server 2003 でERROR_CALL_NOT_IMPLEMENTEDを返します。 アプリケーションでは MprAdminUserSetInfo 関数を 使用する必要があります。]

RasAdminUserSetInfo 関数は、指定したユーザーの RAS アクセス許可とコールバック電話番号を設定します。

構文

DWORD RasAdminUserSetInfo(
  _In_ const WCHAR       *lpszUserAccountServer,
  _In_ const WCHAR       *lpszUser,
  _In_ const PRAS_USER_0 pRasUser0
);

パラメーター

lpszUserAccountServer [in]

ユーザー アカウント データベースを持つプライマリ ドメイン コントローラーまたはバックアップ ドメイン コントローラーの名前を指定する、null で終わる Unicode 文字列へのポインター。 RasAdminGetUserAccountServer 関数を使用して、このサーバー名を取得します。

lpszUser [in]

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

pRasUser0 [in]

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

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

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

値 説明
ERROR_INVALID_DATA
 pRasUser0 バッファーに無効なデータが含まれています。
ERROR_INVALID_CALLBACK_NUMBER
 pRasUser0 バッファーで指定されたコールバック番号に無効な文字が含まれています。
NERR_BufTooSmall
この関数を実行するにはメモリが不足しています。

この関数の拡張エラー情報はありません。 GetLastError を呼び出さないでください。

解説

ユーザーの RAS アクセス許可を設定する場合、RAS_USER_0構造体の bfPrivilege メンバーは、コールバック フラグの少なくとも 1 つを指定する必要があります。 たとえば、ダイヤルイン特権を許可するがコールバック特権を許可しないユーザーの特権を設定するには、 bfPrivilege を RASPRIV_DialinPrivilege に設定します。 |RASPRIV_NoCallback。

要件

要件 値
クライアント サポートの終了
 Windows 2000 Professional
サーバー サポートの終了
 Windows 2000 Server
ヘッダー
Rassapi.h
ライブラリ
Rassapi.lib
[DLL]
Rassapi.dll

関連項目

リモート アクセス サービス (RAS) の概要

RAS サーバー管理機能

RAS_USER_0

RasAdminGetUserAccountServer

RasAdminUserGetInfo