Функция EapPeerInvokeIdentityUI (eapmethodpeerapis.h)
Создает диалоговое окно пользовательского интерактивного интерфейса для получения сведений об удостоверениях пользователя для метода EAP на клиенте.
Синтаксис
DWORD EapPeerInvokeIdentityUI(
[in] EAP_METHOD_TYPE *pEapType,
[in] DWORD dwFlags,
[in] HWND hwndParent,
[in] DWORD dwSizeOfConnectionData,
[in] const BYTE *pConnectionData,
[out] DWORD dwSizeOfUserData,
[in] const BYTE *pUserData,
[out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[out] EAP_ERROR **ppEapError
);
Параметры
[in] pEapType
Структура EAP_METHOD_TYPE , содержащая сведения о поставщике и авторе о методе EAP, используемом для проверки подлинности подключения.
[in] dwFlags
Сочетание флагов EAP , описывающих поведение сеанса проверки подлинности EAP.
[in] hwndParent
Дескриптор родительского окна, которое будет порождать интерактивный диалог пользовательского интерфейса для получения данных удостоверения.
[in] dwSizeOfConnectionData
Размер (в байтах) данных контекста пользовательского интерфейса, указанных в pUIContextData.
[in] pConnectionData
Указатель на непрозрачный буфер байтов, содержащий данные подключения.
[out] dwSizeOfUserData
Задает размер в байтах данных удостоверения пользователя, возвращаемых в dwSizeOfUserData.
[in] pUserData
Указатель на данные пользователя, относящиеся к этой проверке подлинности, используемый для предварительного заполнения данных пользователя. При первом вызове этого API или при запуске нового сеанса проверки подлинности этот параметр имеет значение NULL. В противном случае задайте для этого параметра элемент pUserData структуры, на который указывает параметр ppResult , полученный eapPeerGetResult.
[out] pdwSizeOfUserDataOut
Указывает размер буфера ppUserDataOut в байтах.
[out] ppUserDataOut
Указатель на указатель на возвращенные данные пользователя. Данные передаются в EapPeerBeginSession в качестве входных данных pUserData.
[out] ppwszIdentity
Указатель на возвращенное удостоверение пользователя. Указатель будет включен в пакет ответа удостоверения и вернется на сервер.
[out] ppEapError
Указатель на адрес структуры EAP_ERROR , которая содержит ошибки, возникающие во время выполнения этого вызова функции. После использования данных об ошибках эту память необходимо освободить, вызвав EapPeerFreeErrorMemory.
Возвращаемое значение
None
Remarks
Этот вызов выполняется одноранговым EAPHost с помощью указателя функции на этот API. Этот API должен быть реализован в методе EAP, загруженном EAPHost, и должен строго соответствовать синтаксису и типам параметров, указанным в документации.
Требования
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Целевая платформа | Windows |
Header | eapmethodpeerapis.h |