eaptypes.h) (EAP_ERROR 结构

EAP_ERROR 结构包含有关 EAPHost 操作期间发生的错误的信息。

语法

typedef struct _EAP_ERROR {
  DWORD           dwWinError;
  EAP_METHOD_TYPE type;
  DWORD           dwReasonCode;
  GUID            rootCauseGuid;
  GUID            repairGuid;
  GUID            helpLinkGuid;
  LPWSTR          pRootCauseString;
  LPWSTR          pRepairString;
} EAP_ERROR;

成员

dwWinError

winerror.h 中的错误代码。

type

标识引发错误的 EAP 方法 的EAP_METHOD_TYPE 结构。

dwReasonCode

错误的原因代码。

rootCauseGuid

标识 EAPHost 中错误原因的唯一 ID。 EAP 方法可以定义新的 GUID 并将 GUID 与特定的根本原因相关联。

Value 含义
GUID_EapHost_Default
{0x00000000, 0x0000, 0x0000, 0, 0, 0, 0, 0, 0, 0, 0}
默认错误原因。
GUID_EapHost_Cause_MethodDLLNotFound
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 1}}
EAPHost 找不到 EAP 方法的 DLL。
GUID_EapHost_Cause_EapNegotiationFailed
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0, 0x1C}}
身份验证失败,因为 Windows 没有此网络所需的身份验证方法。
GUID_EapHost_Cause_ThirdPartyMethod_Host_Reset
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 2, 0x12}}
第三方方法的主机未响应,并自动重启。
GUID_EapHost_Cause_XmlMalformed
{0x9612fc67、0x6150、0x4209、{0xa8、0x5e、0xa8、0xd8、0、0、0、0、0x1D}}
EAPHost 配置架构验证失败。
GUID_EapHost_Cause_MethodDoesNotSupportOperation
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0, 0x1E}}
当配置的 EAP 方法不支持请求的操作 (过程调用) 时,EAPHost 将返回此错误。
GUID_EapHost_Cause_EapQecInaccessible
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 3, 0x12}}
EAPHost 无法在已启用网络访问保护 (NAP) 客户端上与 EAP 隔离强制客户端 (QEC) 通信。 当 NAP 服务未响应时,可能会发生此错误。
GUID_EapHost_Cause_Generic_AuthFailure
{0x9612fc67、0x6150、0x4209、{0xa8、0x5e、0xa8、0xd8、0、0、1、4}}
EAPHost 在一般的未指定身份验证失败时返回此错误。
GUID_EapHost_Cause_IdentityUnknown
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 2, 4}}
如果在提交对等标识后验证器身份验证失败,EAPHost 将返回此错误。
GUID_EapHost_Cause_CertStoreInaccessible
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 4}}
验证器或对等方都无法访问证书存储。
GUID_EapHost_Cause_User_CertExpired
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 9}}
EAPHost 发现用户证书已过期。
GUID_EapHost_Cause_User_CertInvalid
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0, 0xA}}
作为身份验证用户的用户证书没有适当的扩展密钥使用 (EKU) 设置。
GUID_EapHost_Cause_User_CertNotFound
{0x9612fc67、0x6150、0x4209、{0xa8、0x5e、0xa8、0xd8、0、0、0、0xB}}
EAPHost 找不到用于身份验证的用户证书。
GUID_EapHost_Cause_User_CertOtherError
{0x9612fc67、0x6150、0x4209、{0xa8、0x5e、0xa8、0xd8、0、0、0、0、0xC}}
使用用户认证进行身份验证时出现未知错误。
GUID_EapHost_Cause_User_CertRejected
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0, 0xD}}
验证器拒绝了用户认证。
GUID_EapHost_Cause_User_CertRevoked
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0xE}}
用于身份验证的用户证书已被吊销。
GUID_EapHost_Cause_User_Account_OtherProblem
{0x9612fc67、0x6150、0x4209、{0xa8、0x5e、0xa8、0xd8、0、0、1、0xE}}
在进行标识交换后收到 EAP 失败,表明身份验证用户帐户出现问题的可能性。
GUID_EapHost_Cause_User_CredsRejected
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 2, 0xE}}
验证器拒绝了用户凭据进行身份验证。
GUID_EapHost_Cause_Server_CertExpired
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 5}}
EAPHost 发现服务器证书已过期。
GUID_EapHost_Cause_Server_CertInvalid
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 6}}
用作身份验证的用户的服务器证书没有适当的扩展密钥用法 (EKU) 设置。
GUID_EapHost_Cause_Server_CertNotFound
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 7}}
EAPHost 找不到用于身份验证的服务器证书。
GUID_EapHost_Cause_Server_CertOtherError
{0x9612fc67、0x6150、0x4209、{0xa8、0x5e、0xa8、0xd8、0、0、1、8}}
服务器证书出现未知错误。
GUID_EapHost_Cause_Server_CertRevoked
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 8}}
用于身份验证的服务器证书已被撤销。
GUID_EapHost_Cause_User_Root_CertExpired
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0, 0xF}}
用户证书验证所需的受信任根证书已过期。
GUID_EapHost_Cause_User_Root_CertInvalid
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0x10}}
身份验证失败,因为用于此网络的根证书无效。
GUID_EapHost_Cause_User_Root_CertNotFound
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0x11}}
EAPHost 在受信任的根证书存储中找不到用于用户认证验证的证书。
GUID_EapHost_Cause_Server_Root_CertNotFound
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 1, 0x12}}
EAPHost 在服务器证书验证的受信任的根证书存储中找不到根证书。
GUID_EapHost_Cause_Server_Root_CertNameRequired
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0x12}}
身份验证失败,因为服务器计算机上的证书未指定服务器名称。

repairGuid

映射到可本地化字符串的唯一 ID,该字符串标识修复操作,可以采取修复报告的错误。

Value 含义
GUID_EapHost_Repair_ContactSysadmin
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 2}}
用户应与网络管理员联系。
GUID_EapHost_Repair_Retry_Authentication
{0x9612fc67、0x6150、0x4209、{0xa8、0x5e、0xa8、0xd8、0、0、1、0x1B}}
用户应再次尝试连接到网络。
GUID_EapHost_Repair_User_AuthFailure
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0x19}}
用户应输入用于网络身份验证的有效凭据。
GUID_EapHost_Repair_User_GetNewCert
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0x1A}}
用户应从网络管理员获取更新的证书。
GUID_EapHost_Repair_User_SelectValidCert
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0x1B}}
用户应使用其他有效的用户证书通过网络进行身份验证。
GUID_EapHost_Repair_Server_ClientSelectServerCert
{0x9612fc67, 0x6150, 0x4209, {0xa8, 0x5e, 0xa8, 0xd8, 0, 0, 0, 0, 0x19}}
用户应使用其他有效的服务器证书对网络进行身份验证。

helpLinkGuid

映射到可本地化字符串的唯一 ID,该字符串指定包含有关错误或修复消息的其他信息的页面的 URL。 EAP 方法可能定义新的 GUID 并与一个特定的帮助链接相关联。

Value 含义
GUID_EapHost_Help_EapConfigureTypes
包含有关配置 EAP 类型的详细信息的页面的 URL。
GUID_EapHost_Help_FailedAuth
包含有关身份验证失败的详细信息的页面的 URL。
GUID_EapHost_Help_ObtainingCerts
{0xf535eea3、0x1bdd、0x46ca、{0xa2、0xfc、0xa6、0x65、0x59、0x39、0xb7、0xe8}}
包含有关获取 EAP 证书的详细信息的页面的 URL。
GUID_EapHost_Help_SelectingCerts
页面的 URL,其中包含有关选择要用于身份验证的相应证书的详细信息。
GUID_EapHost_Help_SetupEapServer
包含有关设置 EAP 服务器的详细信息的页面的 URL。
GUID_EapHost_Help_Troubleshooting
{0x33307acf、0x0698、0x41ba、{0xb0、0x14、0xea、0x0a、0x2e、0xb8、0xd0、0xa8}}
包含有关故障排除的详细信息的页面的 URL。

pRootCauseString

描述错误根本原因的本地化且可读的字符串。

pRepairString

描述可能的修复操作的本地化且可读的字符串。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 eaptypes.h

请参阅

常见 EAPHost API 结构