Функция RasEapInvokeConfigUI (raseapif.h)

Статья
08/25/2023

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

Синтаксис

DWORD RasEapInvokeConfigUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  DWORD dwFlags,
  [in]  BYTE  *pConnectionDataIn,
  [in]  DWORD dwSizeOfConnectionDataIn,
  [out] BYTE  **ppConnectionDataOut,
  [out] DWORD *pdwSizeOfConnectionDataOut
);

Параметры

[in] dwEapTypeId

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

[in] hwndParent

Дескриптор родительского окна для диалогового окна пользовательского интерфейса.

[in] dwFlags

Указывает ноль или несколько следующих флагов, которые соответствуют процессу проверки подлинности.

Flag	Значение
RAS_EAP_FLAG_ROUTER	Указывает, что компьютер, на котором выполняется набор, является маршрутизатором. Отсутствие этого флага указывает, что компьютер, набирающий номер, является клиентом RAS.
RAS_EAP_FLAG_8021X_AUTH	Указывает, что этот сеанс выполняется в беспроводном контексте.
RAS_EAP_FLAG_GUEST_ACCESS	Указывает, требуется ли клиенту гостевой доступ. Этот флаг обычно используется в случае беспроводного подключения, так что если проверка подлинности завершается сбоем в течение N последовательных попыток беспроводного клиента, если настроено на запрос гостевого доступа, то выполняется путем передачи этого флага. Сервер RADIUS должен быть настроен, чтобы разрешить гостевой доступ.

[in] pConnectionDataIn

Указатель на данные подключения, хранящиеся в записи телефонной книги. Если запись телефонной книги не содержит никаких данных, этот параметр имеет значение NULL.

[in] dwSizeOfConnectionDataIn

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

[out] ppConnectionDataOut

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

[out] pdwSizeOfConnectionDataOut

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

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

Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.

Если функции не удалось выделить память для данных конфигурации, возвращаемое значение должно быть ERROR_NOT_ENOUGH_MEMORY.

Если функция завершается сбоем другим способом, возвращаемое значение должно быть соответствующим кодом ошибки из Winerror.h, Raserror.h или Mprerror.h.

Библиотека DLL, реализующая RasEapInvokeConfigUI и RasEapFreeMemory , может поддерживать несколько протоколов проверки подлинности. Параметр dwEapTypeId указывает, для какого протокола следует вызвать пользовательский интерфейс конфигурации.

RAS сохраняет данные подключения, возвращенные RasEapInvokeConfigUI , в записи телефонной книги для подключения на клиентском компьютере.

Требования


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