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 |