EapHostPeerInvokeInteractiveUI 関数 (eaphostpeerconfigapis.h)
ユーザーから資格情報を取得するために使用される対話型ユーザー インターフェイスを生成します。 たとえば、この関数を使用して、スマート カードから資格情報を取得し、ユーザーに対応する PIN の入力を求める UI を生成できます。
EapHostPeerInvokeInteractiveUI は、 シングル スレッド アパートメント用に COM が初期化されたスレッドで呼び出す必要があります。 これは、COM API CoInitialize を呼び出すことによって実現できます。サプリカントが STA スレッド CoUninitialize で終了したら、終了する前に を呼び出す必要があります。
構文
DWORD EapHostPeerInvokeInteractiveUI(
[in] HWND hwndParent,
[in] DWORD dwSizeofUIContextData,
[in] const BYTE *pUIContextData,
[out] DWORD *pdwSizeOfDataFromInteractiveUI,
[out] BYTE **ppDataFromInteractiveUI,
[out] EAP_ERROR **ppEapError
);
パラメーター
[in] hwndParent
構成ダイアログが表示される親ウィンドウのハンドル。
[in] dwSizeofUIContextData
pUIContextData パラメーターが指すバッファーのサイズ (バイト単位)。
[in] pUIContextData
EAPHost からのサプリカント UI コンテキスト データを含むバッファーへのポインター。 コンテキスト データは、 EapHostPeerGetUIContext によって返されます。 バッファーのサイズは dwSizeOfUIContextData です。
[out] pdwSizeOfDataFromInteractiveUI
ppDataFromInteractiveUI パラメーターが指すバッファーのサイズをバイト単位で表す DWORD へのポインター。
[out] ppDataFromInteractiveUI
認証を続行するために必要な対話型 UI からのデータを含むバイト バッファーへのポインターへのポインター。 パラメーター ppDataFromInteractiveUI は、IN パラメーター pUIContextData として EapHostPeerSetUIContext に渡す必要があります。 データを使用した後、 EapHostPeerFreeMemory を呼び出してこのメモリを解放する必要があります。 バッファーのサイズは pdwSizeofDataFromInteractiveUI です。
[out] ppEapError
この関数呼び出しの実行中に EAPHost によって発生したエラーを含む EAP_ERROR 構造体へのポインターへのポインター。 エラー データを使用した後、 EapHostPeerFreeErrorMemory を呼び出してこのメモリを解放する必要があります。
戻り値
なし
解説
サプリカントは EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED を呼び出す必要があります。サプリカントは 、EapHostPeerInvokeInteractiveUI を呼び出すことによってメソッド対話型 UI を呼び出す従来のモデルに頼る必要があります。
呼び出された場合、EapHostPeerInvokeInteractiveUI は、サプリカントが EapHostPeerGetUIContext を呼び出した後、EAP メソッドのユーザー インターフェイスを発生させます。 これは、 EapHostPeerProcessReceivedPacket の呼び出しが EapHostPeerResponseInvokeUi アクション コードを返したときに発生します。 EapHostPeerGetUIContext は、サプリカントが EAPHostPeerInvokeInteractiveUI に渡して UI を発生させる UI コンテキストを返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | eaphostpeerconfigapis.h |
| Library | Eappcfg.lib |
| [DLL] | Eappcfg.dll |