Функция EapHostPeerInvokeInteractiveUI (eaphostpeerconfigapis.h)

Создает интерактивный пользовательский интерфейс, используемый для получения учетных данных от пользователя. Например, эту функцию можно использовать для создания пользовательского интерфейса, который получает учетные данные из смарт-карта и предлагает пользователю ввести соответствующий ПИН-код.

EapHostPeerInvokeInteractiveUI необходимо вызывать для потоков, которые инициализированы com для однопотокового подразделения. Этого можно достичь, вызвав COM API CoInitialize; когда запрашивающий элемент завершил работу с потоком STA CoUninitialize , необходимо вызвать перед выходом.

Синтаксис

DWORD EapHostPeerInvokeInteractiveUI(
  [in]  HWND       hwndParent,
  [in]  DWORD      dwSizeofUIContextData,
  [in]  const BYTE *pUIContextData,
  [out] DWORD      *pdwSizeOfDataFromInteractiveUI,
  [out] BYTE       **ppDataFromInteractiveUI,
  [out] EAP_ERROR  **ppEapError
);

Параметры

[in] hwndParent

Дескриптор родительского окна, в котором появляется диалоговое окно конфигурации.

[in] dwSizeofUIContextData

Размер (в байтах) буфера, на который указывает параметр pUIContextData .

[in] pUIContextData

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

[out] pdwSizeOfDataFromInteractiveUI

Указатель на DWORD, представляющий размер (в байтах) буфера, на который указывает параметр ppDataFromInteractiveUI .

[out] ppDataFromInteractiveUI

Указатель на указатель на буфер байтов, содержащий данные из интерактивного пользовательского интерфейса, необходимые для продолжения проверки подлинности. Параметр ppDataFromInteractiveUI следует передать в EapHostPeerSetUIContext в качестве параметра IN pUIContextData. После использования данных эту память необходимо освободить, вызвав EapHostPeerFreeMemory. Буфер имеет размер pdwSizeofDataFromInteractiveUI.

[out] ppEapError

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

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

None

Remarks

Запрашивающий должен вызывать EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED возвращается, запрашивающий должен прибегнуть к традиционной модели вызова интерактивного пользовательского интерфейса метода путем вызова EapHostPeerInvokeInteractiveUI.

При вызове EapHostPeerInvokeInteractiveUI вызывает пользовательский интерфейс для метода EAP после того, как запрашивающий вызывает EapHostPeerGetUIContext. Это происходит, когда вызов EapHostPeerProcessReceivedPacket возвращает код действия EapHostPeerResponseInvokeUi . EapHostPeerGetUIContext возвращает контекст пользовательского интерфейса, который запрашивающий затем передает в EapHostPeerInvokeInteractiveUI для создания пользовательского интерфейса.

Требования

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

Функции конфигурации запрашивающего участника EAPHost

EapHostPeerGetUIContext

EapHostPeerQueryInteractiveUIInputFields

EapHostPeerSetUIContext