EapHostPeerGetUIContext 函式 (eappapis.h)
從 EAPHost 取得要引發 UI 的使用者介面內容。
EAPHostPeerGetUIContext 一律後面接著下列函式。
語法
DWORD EapHostPeerGetUIContext(
[in] EAP_SESSIONID sessionHandle,
[out] DWORD *pdwSizeOfUIContextData,
[out] BYTE **ppUIContextData,
[out] EAP_ERROR **ppEapError
);
參數
[in] sessionHandle
EAP_SESSIONID 結構的指標，其中包含EAPHost伺服器上這個EAP驗證會話的唯一句柄。 這個句柄會在先前呼叫 EapHostPeerBeginSession 的 pSessionId 參數中傳回。
[out] pdwSizeOfUIContextData
值的指標，指定 ppUIContextData中傳回之UI內容數據緩衝區的大小，以位元組為單位。
[out] ppUIContextData
緩衝區指標的指標，其中包含來自EAPHost的supplicant UI內容數據。 此參數所指向的位址會傳遞至 EapHostPeerInvokeInteractiveUI 作為 IN 參數 pUIContextData。
[out] ppEapError
EAP_ERROR 結構的位址指標。 在呼叫此函式之前，位址應設定為 NULL 。 如果錯誤數據可用，就會收到包含執行此函數調用期間所引發之任何錯誤的 EAP_ERROR 結構地址指標。 使用錯誤數據之後，呼叫 EapHostPeerFreeEapError 以釋放此記憶體。
傳回值
無
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | eappapis.h |
| 程式庫 | Eappprxy.lib |
| Dll | Eappprxy.dll |