EapHostPeerQueryInteractiveUIInputFields 函式 (eaphostpeerconfigapis.h)
EapHostPeerQueryInteractiveUIInputFields函式會取得要在 supplicant 上引發之互動式 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 對等 API 的版本。 |
[in] dwFlags
[in] dwSizeofUIContextData
pUICoNtextData中內容資料的大小，以位元組為單位。
[in] pUIContextData
包含 UI 內容資料的 BLOB 指標，表示為欄位資料的內部指標。 從最內部指標開始，必須將這些內部指標傳遞至 EapHostPeerFreeMemory，以釋放這些內部指標。
[out] pEapInteractiveUIData
接收 EAP_INTERACTIVE_UI_DATA 結構的指標，其中包含 EAP 支援專案上引發之互動式 UI 元件的組態資訊。 呼叫端應該使用 EapHostPeerFreeMemory函數釋放內部指標，從最內部指標開始。
[out] ppEapError
指向 EAP_ERROR 結構的指標，其中包含執行此函式呼叫期間 EAPHost 所引發的任何錯誤。 取用錯誤資料之後，必須藉由呼叫 EapHostPeerFreeErrorMemory釋放此記憶體。
[in, out] ppvReserved
保留供未來使用。 此參數必須設定為 0。
傳回值
無
備註
EapHostPeerQueryInteractiveUIInputFields 可用來支援單一登入 (SSO) 。 supplicant 會使用EapHostPeerBeginSession中的EAP_FLAG_PRE_LOGON旗標，向 EAPHost 指出應該提供 SSO。 如果在呼叫EapHostPeerBeginSession 之後收到 EapHostPeerBeginSession之後收到EapHostPeerResponseInvokeUI動作程式碼，EAPHostPeerQueryInteractiveUIInputFields，稍後會呼叫EapHostPeerQueryUIBlobFromInteractiveUIInputFields。
要求者應該呼叫 EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED 傳回，supplicant 應該藉由呼叫 EapHostPeerInvokeInteractiveUI來叫用方法互動式 UI 的傳統模型。 如果發生錯誤， EapHostPeerQueryInteractiveUIInputFields 會傳回 Null以外的傳回碼。
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | eaphostpeerconfigapis.h |
| 程式庫 | Eappcfg.lib |
| Dll | Eappcfg.dll |