Функция EapMethodAuthenticatorInvokeConfigUI (eapmethodauthenticatorapis.h)

Статья
08/23/2023

Определяет функцию, которая создает диалоговое окно пользовательского интерфейса конфигурации подключения метода EAP на клиенте.

EapMethodAuthenticatorInvokeConfigUI является прототипом функции.

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

Синтаксис

DWORD EapMethodAuthenticatorInvokeConfigUI(
  [in]  EAP_METHOD_TYPE *pEapMethodType,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwFlags,
  [in]  LPCWSTR         pwszMachineName,
  [in]  DWORD           dwSizeOfConfigIn,
  [in]  BYTE            *pConfigIn,
  [out] DWORD           *pdwSizeOfConfigOut,
  [out] BYTE            **ppConfigOut,
  [out] EAP_ERROR       **ppEapError
);

Параметры

[in] pEapMethodType

Указатель на структуру EAP_METHOD_TYPE , содержащую сведения о поставщике и авторе метода EAP, используемого для проверки подлинности подключения.

[in] hwndParent

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

[in] dwFlags

Сочетание флагов EAP , описывающих поведение сеанса проверки подлинности EAP.

[in] pwszMachineName

Имя настраиваемого целевого компьютера. Значение NULL означает, что локальный компьютер настраивается.

[in] dwSizeOfConfigIn

Указывает размер pConfigIn в байтах. Может иметь значение 0.

[in] pConfigIn

Указатель на буфер байтов, содержащий элементы конфигурации. Буфер имеет размер dwSizeOfConfigIn. Этот параметр может иметь значение NULL, если параметр dwSizeOfConfigIn имеет значение 0.

[out] pdwSizeOfConfigOut

Указывает размер (в байтах) данных конфигурации, возвращаемых в ppConfigOut.

[out] ppConfigOut

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

[out] ppEapError

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

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

None

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	eapmethodauthenticatorapis.h

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

Функции метода EAPHost Authenticator

Поделиться через