共用方式為

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_PEER_API_VERSION
1
 EAPHost 對等 API 的版本。

[in] dwFlags

描述 EAP 驗證會話行為的 EAP 旗標組合。

[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

另請參閱

EAPHost Supplicant 組態函式

SSO 和 PLAP