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。
関数が失敗した場合、戻り値は次のいずれかの値になります。
| 値 | 説明 |
|---|---|
|
呼び出し元に十分な特権がありません。 |
|
dwLevel の値が無効です。 |
|
操作を完了するためのリソースが不足しています。 |
|
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 |