MprAdminGetIpv6AddressForUser 関数 (mprapi.h)

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

構文

DWORD MprAdminGetIpv6AddressForUser(
  [in]      WCHAR    *lpwszUserName,
  [in]      WCHAR    *lpwszPortName,
  [in, out] IN6_ADDR *lpdwIpv6Address,
  [out]     BOOL     *bNotifyRelease
);

パラメーター

[in] lpwszUserName

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

[in] lpwszPortName

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

[in, out] lpdwIpv6Address

ユーザーに割り当てられた 0 個または IPv6 アドレス RAS を含む in6_addr構造体への ポインター。

現在、サポートされているビット識別子は 64 ビットのみです。

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

[out] bNotifyRelease

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

戻り値

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

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

解説

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

要件

関連項目

MprAdminReleaseIpv6AddressForUser

RAS 管理 DLL

RAS 管理関数

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