RasEapInvokeConfigUI 函式 (raseapif.h)

發行項
08/25/2023

RAS 連線管理員會呼叫 RasEapInvokeConfigUI 函式以顯示對話方塊，以從使用者取得組態資訊。 RAS 會在建立新的電話簿專案或編輯現有的電話簿專案時呼叫 RasEapInvokeConfigUI ，前提是專案的驗證通訊協定會提供設定使用者介面。

語法

DWORD RasEapInvokeConfigUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  DWORD dwFlags,
  [in]  BYTE  *pConnectionDataIn,
  [in]  DWORD dwSizeOfConnectionDataIn,
  [out] BYTE  **ppConnectionDataOut,
  [out] DWORD *pdwSizeOfConnectionDataOut
);

參數

[in] dwEapTypeId

指定要叫用組態 UI 的驗證通訊協定。

[in] hwndParent

UI 對話方塊的父視窗控制碼。

[in] dwFlags

指定符合驗證程式資格的下列零個或多個旗標。

旗標	意義
RAS_EAP_FLAG_ROUTER	指定撥入的電腦是路由器。缺少此旗標表示電腦撥入是 RAS 用戶端。
RAS_EAP_FLAG_8021X_AUTH	指定此會話正在無線內容中執行。
RAS_EAP_FLAG_GUEST_ACCESS	如果用戶端想要來賓存取，則指定。此旗標通常用於無線連線的情況，因此，如果連續嘗試無線用戶端的 N 個驗證失敗，如果設定為要求來賓存取，則傳遞此旗標即可。 RADIUS 伺服器應該設定為允許來賓存取。

[in] pConnectionDataIn

目前儲存在電話簿專案中之連線資料的指標。如果電話簿專案不包含任何資料，則此參數為 Null。

[in] dwSizeOfConnectionDataIn

指定目前儲存在電話簿專案中的連接資料大小。如果此連線的電話簿專案未包含任何資料，則此參數為零。

[out] ppConnectionDataOut

在成功傳回時，指標指向要儲存在電話簿專案中的新連線資料。此資料不應專屬於目前的電腦;電話簿專案應該可從電腦移植到電腦。

[out] pdwSizeOfConnectionDataOut

DWORD的指標，接收要儲存在電話簿專案中之新連線資料的大小。

傳回值

如果函式成功，傳回值會 NO_ERROR。

如果函式無法配置組態資料的記憶體，則應該 ERROR_NOT_ENOUGH_MEMORY傳回值。

如果函式以其他方式失敗，則傳回值應該是 Winerror.h、Raserror.h 或 Mprerror.h 的適當錯誤碼。

備註

實作 RasEapInvokeConfigUI 和 RasEapFreeMemory 的 DLL 可能支援多個驗證通訊協定。 dwEapTypeId參數會指定要叫用設定 UI 的通訊協定。

RAS 會將 RasEapInvokeConfigUI 所傳回的連接資料儲存在用戶端電腦上連線的電話簿專案中。

需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	raseapif.h