EapHostPeerInvokeInteractiveUI 函式 (eaphostpeerconfigapis.h)
引發互動式使用者介面，用來從使用者取得認證。 例如，此函式可用來引發UI以從智慧卡擷取認證，並提示使用者輸入對應的 PIN。
必須在已針對單一線程 Apartment 初始化 COM 的線程上呼叫 EapHostPeerInvokeInteractiveUI。 呼叫 COM API CoInitialize 即可達成此目的;當 supplicant 已完成 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 的 supplicant UI 內容數據。 EapHostPeerGetUIContext 會傳回內容數據。 緩衝區的大小 為 dwSizeOfUIContextData。
[out] pdwSizeOfDataFromInteractiveUI
DWORD 的指標，代表 ppDataFromInteractiveUI 參數所指向之緩衝區的大小，以位元組為單位。
[out] ppDataFromInteractiveUI
位元組緩衝區指標的指標，其中包含驗證所需之互動式 UI 的數據，才能繼續。 參數 ppDataFromInteractiveUI 應該傳遞至 EapHostPeerSetUIContext 作為 IN 參數 pUIContextData。 取用數據之後，必須呼叫 EapHostPeerFreeMemory 來釋放此記憶體。 緩衝區大小為 pdwSizeofDataFromInteractiveUI。
[out] ppEapError
指向 EAP_ERROR 結構的指標，其中包含執行此函式呼叫期間 EAPHost 所引發的任何錯誤。 取用錯誤數據之後，必須藉由呼叫 EapHostPeerFreeErrorMemory 釋放此記憶體。
傳回值
無
備註
要求者應該呼叫 EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED 傳回，supplicant 應該藉由呼叫 EapHostPeerInvokeInteractiveUI 來依賴叫用方法互動式 UI 的傳統模型。
如果呼叫，EapHostPeerInvokeInteractiveUI 會在要求者呼叫 EapHostPeerGetUIContext 之後引發 EAP 方法的使用者介面。 當 呼叫 EapHostPeerProcessReceivedPacket 傳回 EapHostPeerResponseInvokeUi 動作程式代碼時，就會發生這種情況。 EapHostPeerGetUIContext 會傳回使用者接著傳遞至 EapHostPeerInvokeInteractiveUI 以引發 UI 的 UI 內容。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | eaphostpeerconfigapis.h |
| 程式庫 | Eappcfg.lib |
| Dll | Eappcfg.dll |