RasEapInvokeInteractiveUI 関数 (raseapif.h)

RAS 接続マネージャーは RasEapInvokeInteractiveUI 関数を呼び出して、ユーザーから認証データを取得するためのダイアログを表示します。

構文

DWORD RasEapInvokeInteractiveUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  BYTE  *pUIContextData,
  [in]  DWORD dwSizeOfUIContextData,
        BYTE  **ppDataFromInteractiveUI,
  [out] DWORD *pdwSizeOfDataFromInteractiveUI
);

パラメーター

[in] dwEapTypeId

対話型 UI を呼び出す認証プロトコルを指定します。

[in] hwndParent

ダイアログの親ウィンドウを処理します。

[in] pUIContextData

対話型 UI のコンテキスト データへのポインター。 認証プロトコルは、このデータへのポインターを PPP_EAP_OUTPUT 構造体のメンバーとして提供します。 RAS 接続マネージャーは、RasEapMakeMessage 関数から出力パラメーターとしてPPP_EAP_OUTPUT構造体を受け取ります。

[in] dwSizeOfUIContextData

コンテキスト データのサイズを指定します。 認証プロトコルは、 PPP_EAP_OUTPUT 構造のメンバーとしてサイズを提供します。 RAS 接続マネージャーは、RasEapMakeMessage 関数から出力パラメーターとしてPPP_EAP_OUTPUT構造体を受け取ります。

ppDataFromInteractiveUI

[out[ ポインター変数へのポインター。 正常に戻った場合、このポインター変数は、対話型 UI によって取得されたデータを含むメモリ バッファーを指します。 対話型 UI は、このメモリを割り当てます。 RAS は、このデータを PPP_EAP_INPUT 構造の認証プロトコルに戻し、 RAS は RasEapFreeMemory を呼び出してこのメモリを解放します。

対話型 UI でユーザー固有のデータが取得されない場合は、 ppUserData が指すポインターを NULL に設定する必要があります。

[out] pdwSizeOfDataFromInteractiveUI

対話型 UI から返されるデータのサイズを受け取る DWORD 変数へのポインター。 対話型 UI でユーザー固有のデータが取得されない場合は、 DWORD 変数を 0 に設定する必要があります。

戻り値

関数が成功した場合、戻り値は NO_ERROR。 ppDataFromInteractiveUI パラメーターと lpdwSizeOfDataFromInteractiveUI パラメーターを調べて、関数が対話型 UI からデータを返したかどうかを判断します。

関数がデータのメモリを割り当てられなかった場合は、戻り値を ERROR_NOT_ENOUGH_MEMORYする必要があります。

関数が何らかの方法で失敗した場合、戻り値は Winerror.h、Raserror.h、または Mprerror.h からの適切なエラー コードである必要があります。

解説

RasEapInvokeInteractiveUI 関数と RasEapFreeMemory 関数を実装する DLL では、複数の認証プロトコルがサポートされている場合があります。 dwEapTypeId パラメーターは、対話型 UI を呼び出す認証プロトコルを指定します。

対話型 UI から返されるデータへのポインターは、PPP_EAP_INPUT構造体の pDataFromInteractiveUI メンバーの認証プロトコル に 返されます。 PPP_EAP_INPUT構造体は、パラメーターとして RasEapMakeMessage 関数に渡されます。

対話型ユーザー インターフェイスは、LOWORD(wParam) が IDCANCEL と等しいWM_COMMANDメッセージをサポートする必要があります。

要件

関連項目

EAP 関数

拡張認証プロトコル リファレンス

対話型ユーザー インターフェイス

PPP_EAP_INPUT

PPP_EAP_OUTPUT

RasEapFreeMemory

RasEapGetIdentity

RasEapInvokeConfigUI

RasEapMakeMessage