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

こちらもご覧ください

EAPHost サプリカント構成関数

EapHostPeerGetUIContext

EapHostPeerQueryInteractiveUIInputFields

EapHostPeerSetUIContext