EapHostPeerInvokeConfigUI 函式 (eaphostpeerconfigapis.h)

啟動指定之 EAP 方法的組態使用者介面。

必須在已針對單一線程 Apartment (STA) 初始化 COM 的執行緒上呼叫EapHostPeerInvokeConfigUI。 呼叫 COM API CoInitialize即可達成此目的;當 supplicant 已完成 STA 執行緒 CoUninitialize 之前必須呼叫時。

語法

DWORD EapHostPeerInvokeConfigUI(
  [in]  HWND            hwndParent,
  [in]  DWORD           dwFlags,
  [in]  EAP_METHOD_TYPE eapMethodType,
  [in]  DWORD           dwSizeOfConfigIn,
  [in]  const BYTE      *pConfigIn,
  [out] DWORD           *pdwSizeOfConfigOut,
  [out] BYTE            **ppConfigOut,
  [out] EAP_ERROR       **ppEapError
);

參數

[in] hwndParent

顯示組態對話方塊之父視窗的控制碼。

[in] dwFlags

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

[in] eapMethodType

指定 EAP 方法 的EAP_METHOD_TYPE 結構。

[in] dwSizeOfConfigIn

輸入組態的大小。 可能設定為 0 (零) 。

[in] pConfigIn

包含組態專案的位元組緩衝區指標。 緩衝區的大小 為 dwSizeOfConfigIn。 如果dwSizeOfConfigIn設定為 0 (零) ,此參數可以是Null

[out] pdwSizeOfConfigOut

DWORD 的指標,指定 ppConfigOut所指向之緩衝區的大小。

[out] ppConfigOut

位元組緩衝區指標的指標,其中包含來自使用者的已更新組態資料。 取用資料之後,必須呼叫 EapHostPeerFreeMemory來釋放此記憶體。

[out] ppEapError

指向 EAP_ERROR 結構的指標,其中包含執行此函式呼叫期間 EAPHost 所引發的任何錯誤。 取用錯誤資料之後,必須藉由呼叫 EapHostPeerFreeErrorMemory釋放此記憶體。

傳回值

需求

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

另請參閱

EAPHost Supplicant 組態函式