IWTSProtocolLogonErrorRedirector：：RedirectLogonError 方法 (wtsprotocol.h)

[IWTSProtocolLogonErrorRedirector：：RedirectLogonError 自 Windows Server 2012 起不再可供使用。 请改用 IWRdsProtocolLogonErrorRedirector：：RedirectLogonError。]

查询为响应登录错误而要执行的操作的协议。 远程桌面服务服务调用 RedirectStatus 方法，以查询协议以响应登录错误时要执行的操作。

语法

HRESULT RedirectLogonError(
  [in]  LONG                                ntsStatus,
  [in]  LONG                                ntsSubstatus,
  [in]  LPCWSTR                             pszCaption,
  [in]  LPCWSTR                             pszMessage,
  [in]  UINT                                uType,
  [out] WTS_LOGON_ERROR_REDIRECTOR_RESPONSE *pResponse
);

参数

[in] ntsStatus

一个整数，其中包含有关登录失败的信息。 这可以是以下值之一。

STATUS_QUOTA_EXCEEDED

内存配额不足以分配身份验证包返回的输出缓冲区。

STATUS_ACCOUNT_RESTRICTION

用户帐户和密码是合法的，但用户帐户存在阻止登录的限制。 有关详细信息，请参阅 ntsSubstatus 参数。

STATUS_BAD_VALIDATION_CLASS

身份验证包无法识别提供的身份验证信息。

STATUS_LOGON_FAILURE

登录尝试失败。 未指定失败原因，但典型原因包括用户名拼写错误和密码拼写错误。

STATUS_NO_LOGON_SERVERS

没有域控制器可用于为身份验证请求提供服务。

STATUS_NO_SUCH_PACKAGE

LSA 无法识别指定的身份验证包。

[in] ntsSubstatus

包含登录尝试失败原因的信息的整数。 仅当用户的帐户信息有效且登录被拒绝时，才会设置此值。 这可以包含以下值之一。

STATUS_INVALID_LOGON_HOURS

用户帐户有时间限制，目前不能用于登录。

STATUS_INVALID_WORKSTATION

用户帐户有工作站限制，不能用于从当前工作站登录。

STATUS_PASSWORD_EXPIRED

用户帐户密码已过期。

STATUS_ACCOUNT_DISABLED

用户帐户当前已禁用，不能用于登录。

[in] pszCaption

指向包含消息框的字符串描述文字的指针。

[in] pszMessage

指向包含消息的字符串的指针。

[in] uType

包含消息框类型的整数。 有关详细信息，请参阅 MessageBox 函数。

[out] pResponse

指向 WTS_LOGON_ERROR_REDIRECTOR_RESPONSE 枚举的指针，该枚举指定远程桌面服务对登录错误的首选响应。

返回值

实现此方法时，如果函数成功，则返回 S_OK 。 如果失败，则返回一个 指示错误的 HRESULT 值。 有关常见错误代码的列表，请参阅 通用 HRESULT 值。

要求

另请参阅

IWTSProtocolLogonErrorRedirector