Метод IWTSProtocolLogonErrorRedirector::RedirectLogonError (wtsprotocol.h)

Статья
08/28/2023

[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.

Требования


Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008 R2
Целевая платформа	Windows
Header	wtsprotocol.h

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

IWTSProtocolLogonErrorRedirector

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