EapPeerGetUIContext 函式 (eapmethodpeerapis.h)
從 EAP 方法取得使用者介面內容。 此函式一律後面接著 EapPeerInvokeInteractiveUI 函式,後面接著 EapPeerSetUIContext 函 式。
語法
DWORD EapPeerGetUIContext(
[in] EAP_SESSION_HANDLE sessionHandle,
[out] DWORD *pdwSizeOfUIContextData,
[out] BYTE **ppUIContextData,
[out] EAP_ERROR **ppEapError
);
參數
[in] sessionHandle
EAP_SESSION_HANDLE 結構的指標,其中包含EAPHost伺服器上這個EAP驗證會話的唯一句柄。 這個句柄會在先前呼叫 EapPeerBeginSession 的 pSessionHandle 參數中傳回。
[out] pdwSizeOfUIContextData
值的指標,指定 ppUIContextData中傳回的使用者介面內容數據位元組緩衝區大小。
[out] ppUIContextData
位址的指標,其中包含來自 EAPHost 之要求使用者介面內容數據的位元元組緩衝區。
[out] ppEapError
EAP_ERROR結構的位址指標,其中包含此函數調用執行期間引發的任何錯誤。 取用錯誤數據之後,必須將錯誤數據的指標傳遞至 EapPeerFreeErrorMemory,以釋放此記憶體。
傳回值
無
備註
當先前呼叫指出使用者介面內容可用時,EAPHost 會呼叫 EapPeerGetUIContext。
此呼叫是由對等型 EAPHost 使用此 API 的函式指標來執行。 此 API 必須在 EAPHost 載入的 EAP 方法上實作,而且必須嚴格符合檔中指定的語法和參數類型。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | eapmethodpeerapis.h |