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

Статья
08/25/2023

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

Синтаксис

DWORD RasEapInvokeInteractiveUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  BYTE  *pUIContextData,
  [in]  DWORD dwSizeOfUIContextData,
        BYTE  **ppDataFromInteractiveUI,
  [out] DWORD *pdwSizeOfDataFromInteractiveUI
);

Параметры

[in] dwEapTypeId

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

[in] hwndParent

Дескриптор в родительском окне диалогового окна.

[in] pUIContextData

Указатель на контекстные данные для интерактивного пользовательского интерфейса. Протокол проверки подлинности предоставляет указатель на эти данные как элемент структуры PPP_EAP_OUTPUT . Диспетчер подключений RAS получает структуру PPP_EAP_OUTPUT в качестве выходного параметра из функции RasEapMakeMessage.

[in] dwSizeOfUIContextData

Указывает размер контекстных данных. Протокол проверки подлинности предоставляет размер в качестве члена структуры PPP_EAP_OUTPUT . Диспетчер подключений RAS получает структуру PPP_EAP_OUTPUT в качестве выходного параметра из функции RasEapMakeMessage.

ppDataFromInteractiveUI

[out[ Указатель на переменную указателя. При успешном возвращении эта переменная указателя указывает на буфер памяти, содержащий данные, полученные интерактивным пользовательским интерфейсом. Интерактивный пользовательский интерфейс выделяет эту память. RAS передает эти данные обратно в протокол проверки подлинности в структуре PPP_EAP_INPUT , после чего RAS освобождает эту память путем вызова RasEapFreeMemory.

Если интерактивный пользовательский интерфейс не получает никаких пользовательских данных, для указателя, на который указывает ppUserData , необходимо задать значение NULL.

[out] pdwSizeOfDataFromInteractiveUI

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

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

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

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

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

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

Указатель на данные, возвращаемые из интерактивного пользовательского интерфейса, передается обратно в протокол проверки подлинности в элементе pDataFromInteractiveUI структуры PPP_EAP_INPUT . Структура PPP_EAP_INPUT передается в качестве параметра в функцию RasEapMakeMessage .

Интерактивный пользовательский интерфейс должен поддерживать WM_COMMAND сообщений, где ЗНАЧЕНИЕ LOWORD(wParam) равно IDCANCEL.

Требования


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