EapPeerQueryInteractiveUIInputFields 関数 (eapmethodpeerapis.h)
EapPeerQueryInteractiveUIInputFields 関数は、サプリカントで発生する対話型 UI コンポーネントの入力フィールドを提供する EAP メソッド API の実装を定義します。
構文
DWORD EapPeerQueryInteractiveUIInputFields(
[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 のバージョン番号。 0 に設定する必要があります。
[in] dwFlags
EAP 認証セッションの動作を記述する EAP フラグ の組み合わせ。
[in] dwSizeofUIContextData
pUIContextData のコンテキスト データのサイズ (バイト単位)。
[in] pUIContextData
フィールド データへの内部ポインターとして表される UI コンテキスト データを含む BLOB へのポインター。 サプリカントは、EAPHost ランタイム API からこれらの内部ポインターを取得しました。
[out] pEapInteractiveUIData
EAP サプリカントで発生する対話型 UI コンポーネントの構成情報を含む EAP_INTERACTIVE_UI_DATA 構造体を受け取るポインター。
[out] ppEapError
この関数呼び出しの実行中に発生したエラーを含む EAP_ERROR 構造体のアドレスへのポインター。 エラー データを使用した後、エラー データへのポインターを EapPeerFreeErrorMemory に渡すことで、このメモリを解放する必要があります。
[in, out] ppvReserved
将来利用するために予約されています。 NULL に設定する必要があります
戻り値
なし
解説
EapPeerQueryInteractiveUIInputFields を使用して、シングル サインオン (SSO) をサポートできます。 EapPeerBeginSession のEAP_FLAG_PRE_LOGON フラグは、SSO を提供する必要があることを EAPHost に示します。 EapPeerBeginSession を呼び出した後に EapPeerResponseInvokeUI アクション コードを受信した場合、EAPHost は EapPeerQueryInteractiveUIInputFields を呼び出し、後で EapPeerQueryUIBlobFromInteractiveUIInputFields を呼び出します。
サプリカントは、返される EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED を常に呼び出す必要があります。サプリカントは EapPeerInvokeInteractiveUI を呼び出してメソッド対話型 UI を呼び出す従来のモデルに頼る必要があります。 エラーが発生した場合、 EapPeerQueryInteractiveUIInputFields は NULL 以外のリターン コードを返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | eapmethodpeerapis.h |