EapHostPeerGetMethodProperties 函数 (eaphostpeerconfigapis.h)
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
指向包含不透明用户数据 BLOB 的字节缓冲区的指针。 此参数可以为 NULL。
[out] pMethodPropertyArray
指向方法属性数组 EAP_METHOD_PROPERTY_ARRAY的指针。 调用方应使用 EapHostPeerFreeMemory 从最内部指针开始释放内部指针。 仅当类型为 empvtString 时，调用方才应释放 empvString 值。
[out] ppEapError
指向包含 EAPHost 在执行此函数调用期间引发的任何错误的 EAP_ERROR 结构的指针的指针。 使用错误数据后，必须通过将指针传递到 EapHostPeerFreeErrorMemory 来释放此内存。
返回值
无
备注
EapHostPeerGetMethodProperties 允许用户通过 EAPHost 请求接口检索 EAP 方法的属性。 此 API 返回的属性可能与 EapHostPeerGetMethods 函数返回的属性不同。 EapHostPeerGetMethodProperties 函数返回特定连接和用户数据的 EAP 方法的属性。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 7 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | eaphostpeerconfigapis.h |
| Library | Eappcfg.lib |
| DLL | Eappcfg.dll |