Share via

EapHostPeerQueryInteractiveUIInputFields 関数 (eaphostpeerconfigapis.h)

  • [アーティクル]

EapHostPeerQueryInteractiveUIInputFields 関数は、サプリカントで発生する対話型 UI コンポーネントの入力フィールドを取得します。

構文

DWORD EapHostPeerQueryInteractiveUIInputFields(
  [in]      DWORD                   dwVersion,
  [in]      DWORD                   dwFlags,
  [in]      DWORD                   dwSizeofUIContextData,
  [in]      const BYTE              *pUIContextData,
  [out]     EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
  [out]     EAP_ERROR               **ppEapError,
  [in, out] LPVOID                  *ppvReserved
);

パラメーター

[in] dwVersion

API のバージョン番号。

値 意味
EAPHOST_PEER_API_VERSION
1
 EAPHost ピア API のバージョン。

[in] dwFlags

EAP 認証セッションの動作を記述する EAP フラグ の組み合わせ。

[in] dwSizeofUIContextData

pUIContextData のコンテキスト データのサイズ (バイト単位)。

[in] pUIContextData

フィールド データへの内部ポインターとして表される UI コンテキスト データを含む BLOB へのポインター。 これらの内部ポインターは、最も内側のポインターから始めて EapHostPeerFreeMemory に渡すことによって解放する必要があります。

[out] pEapInteractiveUIData

EAP サプリカントで発生する対話型 UI コンポーネントの構成情報を含む EAP_INTERACTIVE_UI_DATA 構造体を受け取るポインター。 呼び出し元は、最も内側のポインターから始まる関数 EapHostPeerFreeMemory を使用して、内部ポインターを解放する必要があります。

[out] ppEapError

この関数呼び出しの実行中に EAPHost によって発生したエラーを含む EAP_ERROR 構造体へのポインター。 エラー データを使用した後、 EapHostPeerFreeErrorMemory を呼び出してこのメモリを解放する必要があります。

[in, out] ppvReserved

将来利用するために予約されています。 このパラメーターは 0 に設定する必要があります。

戻り値

なし

解説

EapHostPeerQueryInteractiveUIInputFields を使用して、シングル サインオン (SSO) をサポートできます。 サプリカントは EapHostPeerBeginSession のEAP_FLAG_PRE_LOGON フラグを使用して、SSO を提供する必要があることを EAPHost に示します。 EapHostPeerBeginSession を呼び出した後に EapHostPeerResponseInvokeUI アクション コードを受信した場合、EAPHost は EapHostPeerQueryInteractiveUIInputFields を呼び出し、後で EapHostPeerQueryUIBlobFromInteractiveUIInputFields を呼び出します。

サプリカントは 、返されるEAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED を呼び出す必要があります。サプリカントは、 EapHostPeerInvokeInteractiveUI を呼び出してメソッド対話型 UI を呼び出す従来のモデルに頼る必要があります。 エラーが発生した場合、 EapHostPeerQueryInteractiveUIInputFields は NULL 以外のリターン コードを返します。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー eaphostpeerconfigapis.h
Library Eappcfg.lib
[DLL] Eappcfg.dll

関連項目

EAPHost サプリカント構成関数

SSO と PLAP