RasEapInvokeInteractiveUI 函式 (raseapif.h)

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。

需求

另請參閱

EAP 函式

可延伸驗證通訊協定參考

互動式使用者介面

PPP_EAP_INPUT

PPP_EAP_OUTPUT

RasEapFreeMemory

RasEapGetIdentity

RasEapInvokeConfigUI

RasEapMakeMessage