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

Статья
08/23/2023

Функция EapHostPeerGetMethodProperties используется для получения свойств метода EAP с учетом подключения и пользовательских данных.

Синтаксис

DWORD EapHostPeerGetMethodProperties(
  [in]  DWORD                     dwVersion,
  [in]  DWORD                     dwFlags,
  [in]  EAP_METHOD_TYPE           eapMethodType,
  [in]  HANDLE                    hUserImpersonationToken,
  [in]  DWORD                     dwEapConnDataSize,
  [in]  const BYTE                *pbEapConnData,
  [in]  DWORD                     dwUserDataSize,
  [in]  const BYTE                *pbUserData,
  [out] EAP_METHOD_PROPERTY_ARRAY *pMethodPropertyArray,
  [out] EAP_ERROR                 **ppEapError
);

Параметры

[in] dwVersion

Номер версии API. Задайте для этого параметра нулевое значение.

[in] dwFlags

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

[in] eapMethodType

Структура EAP_METHOD_TYPE , указывающая метод EAP, который будет использоваться запрашивающим.

[in] hUserImpersonationToken

Дескриптор маркера олицетворения пользователя для использования в этом сеансе.

[in] dwEapConnDataSize

Размер (в байтах) буфера данных подключения, предоставленного в pbEapConnData.

[in] pbEapConnData

Данные подключения, используемые для метода EAP. Если задано значение NULL, возвращается статическое свойство метода, настроенное в реестре.

[in] dwUserDataSize

Размер (в байтах) буфера данных пользователя, предоставленного в pbUserData.

[in] pbUserData

Указатель на буфер байтов, содержащий большой двоичный объект непрозрачных пользовательских данных. Этот параметр может принимать значение NULL.

[out] pMethodPropertyArray

Указатель на массив свойств метода EAP_METHOD_PROPERTY_ARRAY. Вызывающий объект должен освободить внутренние указатели с помощью EapHostPeerFreeMemory , начиная с самого внутреннего указателя. Вызывающий объект должен освободить значение empvString , только если типом является empvtString.

[out] ppEapError

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

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

None

Remarks

EapHostPeerGetMethodProperties позволяет пользователю получать свойства метода EAP через интерфейс запрашивающего EAPHost. Свойства, возвращаемые этим API, могут отличаться от свойств, возвращаемых функцией EapHostPeerGetMethods . Функция EapHostPeerGetMethodProperties возвращает свойства метода EAP для определенного подключения и пользовательских данных.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	eaphostpeerconfigapis.h
Библиотека	Eappcfg.lib
DLL	Eappcfg.dll

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

Функции конфигурации запрашивающего приложения EAPHost

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