共用方式為


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驗證會話的唯一句柄。 這個句柄會在先前呼叫 EapPeerBeginSessionpSessionHandle 參數中傳回。

[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

另請參閱

EAPHost 對等方法 Run-Time 函式

EapPeerInvokeInteractiveUI

EapPeerSetUIContext