Функция 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 , содержащую уникальный дескриптор для этого сеанса проверки подлинности EAP на сервере EAPHost. Этот дескриптор возвращается в параметре pSessionHandle при предыдущем вызове EapPeerBeginSession.

[out] pdwSizeOfUIContextData

Указатель на значение, указывающее размер байтового буфера контекста пользовательского интерфейса, возвращаемого в ppUIContextData.

[out] ppUIContextData

Указатель на адрес, содержащий буфер байтов с запрашиваемыми данными контекста пользовательского интерфейса из EAPHost.

[out] ppEapError

Указатель на адрес структуры EAP_ERROR , содержащей все ошибки, возникающие при выполнении этого вызова функции. После использования данных об ошибках эта память должна быть освобождена путем передачи указателя на данные об ошибках в EapPeerFreeErrorMemory.

Возвращаемое значение

None

Remarks

EapPeerGetUIContext вызывается EAPHost, когда предыдущий вызов указывает, что контекст пользовательского интерфейса доступен.

Этот вызов выполняется одноранговым EAPHost с помощью указателя функции на этот API. Этот API должен быть реализован в методе EAP, загруженном EAPHost, и должен строго соответствовать синтаксису и типам параметров, указанным в документации.

Требования

См. также раздел

Функции однорангового узла EAPHost Run-Time

EapPeerInvokeInteractiveUI

EapPeerSetUIContext