eapPeerSetUIContext 函式 (eapmethodpeerapis.h)

提供EAP方法的使用者介面內容。 此函式會在透過 EapPeerGetUIContext 函式引發 UI 之後呼叫。

語法

DWORD EapPeerSetUIContext(
  [in]  EAP_SESSION_HANDLE  sessionHandle,
  [in]  DWORD               dwSizeOfUIContextData,
  [in]  const BYTE          *pUIContextData,
  [in]  EapPeerMethodOutput *pEapOutput,
  [out] EAP_ERROR           **ppEapError
);

參數

[in] sessionHandle

EAP_SESSION_HANDLE 結構的指標，其中包含EAPHost伺服器上這個EAP驗證會話的唯一句柄。 這個句柄會在先前呼叫 EapPeerBeginSession 的 pSessionHandle 參數中傳回。

[in] dwSizeOfUIContextData

值的指標，指定 pUIContextData 中提供的 UI 內容數據位元組緩衝區大小。

[in] pUIContextData

位址的指標，其中包含要設定於 EAPHost 上之新支援的 UI 內容數據之位元組緩衝區。

[in] pEapOutput

EapPeerMethodOutput 結構的指標，其中包含封包進程作業的輸出。

[out] ppEapError

EAP_ERROR結構的位址指標，其中包含此函數調用執行期間引發的任何錯誤。 取用錯誤數據之後，必須將指標傳遞至 EapPeerFreeErrorMemory 來釋放此記憶體。

傳回值

無

備註

此呼叫是由對等型 EAPHost 使用此 API 的函式指標來執行。 此 API 必須在 EAPHost 載入的 EAP 方法上實作，而且必須嚴格符合檔中指定的語法和參數類型。

規格需求

另請參閱

EAPHost 對等方法 Run-Time 函式

EapPeerGetUIContext