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

Статья
03/04/2024

Запрашивает у протокола действие, выполняемое в ответ на ошибку входа. Метод RedirectStatus вызывается службой удаленных рабочих столов для запроса протокола для выполнения действия в ответ на ошибку входа.

Синтаксис

HRESULT RedirectLogonError(
  [in]  LONG                                 ntsStatus,
  [in]  LONG                                 ntsSubstatus,
  [in]  LPCWSTR                              pszCaption,
  [in]  LPCWSTR                              pszMessage,
  [in]  UINT                                 uType,
  [out] WRDS_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

Указатель на перечисление WRDS_LOGON_ERROR_REDIRECTOR_RESPONSE , указывающее для службы удаленных рабочих столов предпочтительный ответ на ошибку входа.

Возвращаемое значение

При реализации этого метода возвращайте S_OK , если функция выполнена успешно. В случае сбоя возвращается значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Windows
Header	wtsprotocol.h

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

IWRdsProtocolLogonErrorRedirector

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