MprAdminUserGetInfo 関数 (mprapi.h)

[アーティクル]
02/29/2024

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