RasEapInvokeConfigUI 関数 (raseapif.h)
RAS 接続マネージャーは RasEapInvokeConfigUI 関数を呼び出して、ユーザーから構成情報を取得するダイアログを表示します。 RAS は、新しい電話帳エントリが作成されたとき、または既存の電話帳エントリが編集されたときに RasEapInvokeConfigUI を呼び出します(エントリの認証プロトコルで構成ユーザー インターフェイスが提供されている場合)。
構文
DWORD RasEapInvokeConfigUI(
[in] DWORD dwEapTypeId,
[in] HWND hwndParent,
[in] DWORD dwFlags,
[in] BYTE *pConnectionDataIn,
[in] DWORD dwSizeOfConnectionDataIn,
[out] BYTE **ppConnectionDataOut,
[out] DWORD *pdwSizeOfConnectionDataOut
);
パラメーター
[in] dwEapTypeId
構成 UI を呼び出す認証プロトコルを指定します。
[in] hwndParent
UI ダイアログの親ウィンドウへのハンドル。
[in] dwFlags
認証プロセスを修飾する次のフラグを 0 個以上指定します。
[in] pConnectionDataIn
電話帳エントリに現在格納されている接続データへのポインター。 phone-book エントリにデータが含まれていない場合、このパラメーターは NULL です。
[in] dwSizeOfConnectionDataIn
電話帳エントリに現在格納されている接続データのサイズを指定します。 この接続の電話帳エントリにデータが含まれていない場合、このパラメーターは 0 です。
[out] ppConnectionDataOut
正常に戻った場合に、電話帳エントリに格納する新しい接続データを指すポインターへのポインター。 このデータのいずれも、現在のコンピューターに固有である必要はありません。phone-book エントリは、コンピューター間で移植可能である必要があります。
[out] pdwSizeOfConnectionDataOut
電話帳エントリに格納する新しい接続データのサイズを受け取る DWORD へのポインター。
戻り値
関数が成功した場合、戻り値は NO_ERROR。
関数が構成データにメモリを割り当てられなかった場合は、戻り値を ERROR_NOT_ENOUGH_MEMORYする必要があります。
関数が他の方法で失敗した場合、戻り値は Winerror.h、Raserror.h、または Mprerror.h からの適切なエラー コードである必要があります。
解説
RasEapInvokeConfigUI と RasEapFreeMemory を実装する DLL では、複数の認証プロトコルがサポートされている場合があります。 dwEapTypeId パラメーターは、構成 UI を呼び出すプロトコルを指定します。
RAS は、 RasEapInvokeConfigUI によって返された接続データを、クライアント コンピューター上の接続の電話帳エントリに格納します。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | raseapif.h |