RasEapInvokeInteractiveUI 函式 (raseapif.h)

發行項
08/25/2023

RAS 連接管理員會呼叫 RasEapInvokeInteractiveUI 函式來顯示對話方塊，以從使用者取得驗證資料。

語法

DWORD RasEapInvokeInteractiveUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  BYTE  *pUIContextData,
  [in]  DWORD dwSizeOfUIContextData,
        BYTE  **ppDataFromInteractiveUI,
  [out] DWORD *pdwSizeOfDataFromInteractiveUI
);

參數

[in] dwEapTypeId

指定要叫用互動式 UI 的驗證通訊協定。

[in] hwndParent

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

[in] pUIContextData

互動式 UI 的內容資料指標。驗證通訊協定會提供此資料的指標作為 PPP_EAP_OUTPUT 結構的成員。 RAS 連線管理員會從RasEapMakeMessage函式接收PPP_EAP_OUTPUT結構作為輸出參數。

[in] dwSizeOfUIContextData

指定內容資料的大小。驗證通訊協定提供大小作為 PPP_EAP_OUTPUT 結構的成員。 RAS 連線管理員會從RasEapMakeMessage函式接收PPP_EAP_OUTPUT結構作為輸出參數。

ppDataFromInteractiveUI

[out[ 指標變數的指標。成功傳回時，此指標變數會指向記憶體緩衝區，其中包含互動式 UI 取得的資料。互動式 UI 會配置此記憶體。 RAS 會將此資料傳回 PPP_EAP_INPUT 結構中的驗證通訊協定，然後 RAS 藉由呼叫 RasEapFreeMemory釋放此記憶體。

如果互動式 UI 未取得任何使用者特定資料， 則 ppUserData 指向的指標應該設定為 Null。

[out] pdwSizeOfDataFromInteractiveUI

接收從互動式 UI 傳回之資料大小的 DWORD 變數指標。如果互動式 UI 未取得任何使用者特定資料， 則 DWORD 變數應該設定為零。

傳回值

如果函式成功，傳回值會 NO_ERROR。檢查 ppDataFromInteractiveUI 和 lpdwSizeOfDataFromInteractiveUI 參數，以判斷函式是否從互動式 UI 傳回資料。

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

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

備註

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

從互動式 UI 傳回之資料的指標會傳回至PPP_EAP_INPUT結構之 pDataFromInteractiveUI成員中的驗證通訊協定。 PPP_EAP_INPUT結構會當做參數傳遞至RasEapMakeMessage函式。

互動式使用者介面必須支援 WM_COMMAND 訊息，其中 LOWORD (wParam) 等於 IDCANCEL。

需求


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