EapPeerGetConfigBlobAndUserBlob 函数 (eapmethodpeerapis.h)

EapPeerGetConfigBlobAndUserBlob 方法允许 EAP 方法开发人员提供方法支持的各种连接属性和用户属性。 EAPHost 调用此函数以创建 EAP 方法的连接属性和用户属性。

语法

DWORD EapPeerGetConfigBlobAndUserBlob(
  [in]  DWORD           dwFlags,
  [in]  EAP_METHOD_TYPE eapMethodType,
  [in]  EapCredential   eapCredential,
  [out] DWORD           *pdwConfigBlobSize,
  [out] BYTE            **ppConfigBlob,
  [out] DWORD           *pdwUserBlobSize,
  [out] BYTE            **ppUserBlob,
  [out] EAP_ERROR       **ppEapError
);

参数

[in] dwFlags

描述 EAP 身份验证会话行为的 EAP 标志的组合。

[in] eapMethodType

EAP_METHOD_TYPE结构，其中包含有关用于对连接进行身份验证的 EAP 方法的供应商和作者信息。

[in] eapCredential

包含凭据类型和相应凭据的 EapCredential 结构。

[out] pdwConfigBlobSize

接收指向 ppConfigBlob 参数的大小（以字节为单位）的指针。

[out] ppConfigBlob

接收指向指针的指针，该指针包含具有已配置连接数据的字节缓冲区。

[out] pdwUserBlobSize

接收指向 ppUserBlob 参数的大小（以字节为单位）的指针。

[out] ppUserBlob

接收指向一个指针的指针，该指针包含包含方法的用户数据的字节缓冲区。

[out] ppEapError

指向 EAP_ERROR 结构的地址的指针，该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过调用 EapPeerFreeErrorMemory 来释放此内存。

返回值

当此函数能够生成正确的连接和用户 Blob 时，它应返回 ERROR_SUCCESS 。 在所有其他情况下，它将返回相应的窗口错误。

备注

此调用由基于对等的 EAPHost 使用指向此 API 的函数指针执行。 此 API 必须在 EAPHost 加载的 EAP 方法上实现，并且必须严格遵循文档中指定的语法和参数类型。

要求

请参阅

EAP 标志

EAP_ERROR

EAP_METHOD_TYPE

EapCredential

EapPeerFreeErrorMemory