MprAdminUserGetInfo 関数 (mprapi.h)

  • [アーティクル]

MprAdminUserGetInfo 関数は、特定のユーザーのすべての RAS 情報を取得します。

構文

DWORD MprAdminUserGetInfo(
  [in]  LPCWSTR lpszServer,
  [in]  LPCWSTR lpszUser,
  [in]  DWORD   dwLevel,
  [out] LPBYTE  lpbBuffer
);

パラメーター

[in] lpszServer

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

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

[in] lpszUser

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

[in] dwLevel

このパラメーターには、0 または 1 を指定できます。

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

[out] lpbBuffer

RAS_USER_0またはRAS_USER_1構造体へのポインター。 呼び出し元は、この構造体のメモリを割り当てる (解放する) 必要があります。 正常に戻ると、この構造体には、指定されたユーザーの RAS データが含まれます。

Windows NT Server 4.0 with SP3 以降: dwLevel パラメーターで 0 を指定した場合、lpbBuffer はRAS_USER_0構造体を指す必要があります。

戻り値

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

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

値 意味
ERROR_ACCESS_DENIED
 呼び出し元に十分な特権がありません。
ERROR_INVALID_LEVEL
 dwLevel の値が無効です。
ERROR_INVALID_PARAMETER
 lpbBuffer が NULL です
ERROR_NO_SUCH_USER
 lpwsUserName で指定されたユーザーが、lpwsServerName で指定されたサーバーに存在しません。

注釈

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

要件

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

こちらもご覧ください

MprAdminGetPDCServer

MprAdminUserSetInfo

RAS 管理関数

RAS_USER_0

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