EapPeerQueryInteractiveUIInputFields 函式 (eapmethodpeerapis.h)
EapPeerQueryInteractiveUIInputFields 函式會定義 EAP 方法 API 的實作,以提供要在支援專案上引發之互動式 UI 元件的輸入字段。
語法
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 版本號碼。 必須設定為零。
[in] dwFlags
描述 EAP 驗證會話行為的 EAP 旗標 組合。
[in] dwSizeofUIContextData
pUIContextData 中內容數據的大小,以位元組為單位。
[in] pUIContextData
包含UI內容數據的BLOB指標,表示為欄位數據的內部指標。 要求者從EAPHost運行時間 API 取得這些內部指標。
[out] pEapInteractiveUIData
接收 EAP_INTERACTIVE_UI_DATA 結構的指標,其中包含EAP支援專案上引發之互動式UI元件的元件資訊。
[out] ppEapError
EAP_ERROR結構的位址指標,其中包含此函數調用執行期間引發的任何錯誤。 取用錯誤數據之後,必須將錯誤數據的指標傳遞至 EapPeerFreeErrorMemory,以釋放此記憶體。
[in, out] ppvReserved
保留供日後使用。 必須設定為 NULL
傳回值
無
備註
可以使用 EapPeerQueryInteractiveUIInputFields 來支援單一登錄 (SSO) 。 EapPeerBeginSession 中的EAP_FLAG_PRE_LOGON旗標會向 EAPHost 指出應該提供 SSO。 如果在呼叫 EapPeerBeginSession 之後收到 EapPeerResponseInvokeUI 動作程式代碼,EAPHost 接著會呼叫 EapPeerQueryInteractiveUIInputFields,然後呼叫 EapPeerQueryUIBlobFromInteractiveUIInputFields。
成功者應該呼叫一律呼叫 EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED 傳回,建議者應該呼叫 EapPeerInvokeInteractiveUI 來叫用方法互動式 UI 的傳統模型。 如果發生錯誤, EapPeerQueryInteractiveUIInputFields 會傳回 NULL 以外的傳回碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | eapmethodpeerapis.h |