共用方式為

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

另請參閱

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO 和 PLAP