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 內容。

規格需求

另請參閱

EAPHost Supplicant 組態函式

EapHostPeerGetUIContext

EapHostPeerQueryInteractiveUIInputFields

EapHostPeerSetUIContext