共用方式為

EapHostPeerQueryUIBlobFromInteractiveUIInputFields 函式 (eaphostpeerconfigapis.h)

  • 發行項

EapHostPeerQueryUIBlobFromInteractiveUIInputFields 函式會將使用者資訊轉換成 EAPHost 運行時間函式可以使用的使用者 BLOB。

語法

DWORD EapHostPeerQueryUIBlobFromInteractiveUIInputFields(
  [in]      DWORD                         dwVersion,
  [in]      DWORD                         dwFlags,
  [in]      DWORD                         dwSizeofUIContextData,
  [in]      const BYTE                    *pUIContextData,
  [in]      const EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
  [in, out] DWORD                         *pdwSizeOfDataFromInteractiveUI,
  [in, out] BYTE                          **ppDataFromInteractiveUI,
  [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，從最內層指標開始。

[in] pEapInteractiveUIData

接收 EAP_INTERACTIVE_UI_DATA 結構的指標，其中包含EAP支援專案上引發之互動式UI元件的元件資訊。

[in, out] pdwSizeOfDataFromInteractiveUI

DWORD 的指標，指定 ppDataFromInteractiveUI 所指向之緩衝區的大小，以位元組為單位。 如果此值未設定為零，則必須將此參數中所指定大小的緩衝區指標提供給 ppDataFromInteractiveUI。

[in, out] ppDataFromInteractiveUI

接收可用於驗證之認證的 BLOB 的指標。 呼叫端應該使用 函式 EapHostPeerFreeMemory 釋放內部指標，從最內部指標開始。 如果為此參數提供非 Null 值， (表示現有的數據 BLOB 會傳遞給它) ，則會更新提供的數據 BLOB，並在此參數中傳回。 如果提供非 NULL BLOB 值，則應該使用 LocalAlloc 函式。

[out] ppEapError

指向 EAP_ERROR 結構的指標，其中包含此函數調用執行期間 EAPHost 所引發的任何錯誤。 取用錯誤數據之後，必須呼叫 EapHostPeerFreeErrorMemory 來釋放此記憶體。

[in, out] ppvReserved

保留供未來使用。 此參數必須設定為 0。

傳回值

無

備註

Supplicant API 呼叫順序。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 eaphostpeerconfigapis.h
程式庫 Eappcfg.lib
Dll Eappcfg.dll

另請參閱

EAPHost Supplicant 組態函式

SSO 和 PLAP