MprAdminGetIpAddressForUser 関数 (mprapi.h)

RAS は、IP アドレスを必要とするユーザーごとに MprAdminGetIpAddressForUser 関数を 1 回呼び出します。 RAS は、RAS がユーザーに対して選択した IP アドレスを使用して関数を呼び出します。 この関数を実装するサード パーティ DLL では、このアドレスを独自に選択した 1 つに変更できます。

構文

DWORD MprAdminGetIpAddressForUser(
  [in]      WCHAR *lpwszUserName,
  [in]      WCHAR *lpwszPortName,
  [in, out] DWORD *lpdwIpAddress,
  [out]     BOOL  *bNotifyRelease
);

パラメーター

[in] lpwszUserName

IP アドレスを必要とするユーザーの名前を指定する Unicode 文字列へのポインター。

[in] lpwszPortName

ユーザーが接続しようとしているポートの名前を指定する Unicode 文字列へのポインター。

[in, out] lpdwIpAddress

入力時に、ユーザーに割り当てられた 0 個または IP アドレス RAS を含む DWORD 変数へのポインター。

出力時に RAS が 0 を指定した場合、DLL はユーザーの IP アドレスを割り当てます。 この場合、DLL が IP アドレスを割り当てない場合、ユーザーは接続できません。 RAS が IP アドレスを指定した場合、DLL はアドレスを受け入れるか、別のアドレスに置き換えます。

[out] bNotifyRelease

BOOL 変数へのポインター。 DLL でこの変数が TRUE に設定されている場合、RAS はユーザーの切断時に MprAdminReleaseIpAddress を呼び出します。 それ以外の場合、RAS は、この IP アドレスが解放されたときに DLL に通知しません。

戻り値

関数が成功した場合は、戻り値をNO_ERRORする必要があります。

関数がNO_ERROR以外のものを返す場合、RAS は接続を終了します。

解説

RAS では、複数の管理 DLL がサポートされています。 ただし、RAS は MprAdminGetIpAddressForUser を実装してエクスポートする最初の DLL でのみ呼び出します。 RAS は、他の DLL 内のこれらの関数の実装を無視します。 RAS は、レジストリに一覧表示されている順序で、これらの関数の DLL をチェック します。

管理 DLL では 、MprAdminGetIpAddressForUser 関数を実装する必要はありません。 ただし、DLL が MprAdminGetIpAddressForUser を実装する場合は、 MprAdminReleaseIpAddress も実装する必要があります。

MPrAdminGetIpAddressForUser 内から RAS 管理関数または RAS ユーザー管理機能を呼び出さないでください。 コールアウト関数内から行われた場合、これらの関数の呼び出しは返されません。

要件

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

関連項目

MprAdminReleaseIpAddress

RAS 管理 DLL

RAS 管理関数

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