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 方法上實作，而且必須嚴格符合檔中指定的語法和參數類型。

規格需求

另請參閱

EAPHost 對等方法 Run-Time 函式

EapPeerInvokeInteractiveUI

EapPeerSetUIContext