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 コンテキストを返します。

要件

こちらもご覧ください

EAPHost サプリカント構成関数

EapHostPeerGetUIContext

EapHostPeerQueryInteractiveUIInputFields

EapHostPeerSetUIContext