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メッセージをサポートする必要があります。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | raseapif.h |