Método IWRdsProtocolLogonErrorRedirector::RedirectLogonError (wtsprotocol.h)
Consulta o protocolo para que a ação seja executada em resposta a um erro de logon. O método RedirectStatus é chamado pelo serviço de Serviços de Área de Trabalho Remota para consultar o protocolo para que a ação seja tomada em resposta a um erro de logon.
Sintaxe
HRESULT RedirectLogonError(
[in] LONG ntsStatus,
[in] LONG ntsSubstatus,
[in] LPCWSTR pszCaption,
[in] LPCWSTR pszMessage,
[in] UINT uType,
[out] WRDS_LOGON_ERROR_REDIRECTOR_RESPONSE *pResponse
);
Parâmetros
[in] ntsStatus
Um inteiro que contém informações sobre a falha de logon. Esse pode ser um dos valores a seguir.
STATUS_QUOTA_EXCEEDED
A cota de memória é insuficiente para alocar o buffer de saída retornado pelo pacote de autenticação.
STATUS_ACCOUNT_RESTRICTION
A conta de usuário e a senha são legítimas, mas a conta de usuário tem uma restrição que impede o logon no momento. Para obter mais informações, consulte o parâmetro ntsSubstatus .
STATUS_BAD_VALIDATION_CLASS
As informações de autenticação fornecidas não são reconhecidas pelo pacote de autenticação.
STATUS_LOGON_FAILURE
Falha na tentativa de logon. O motivo da falha não é especificado, mas os motivos típicos incluem nomes de usuário com ortografia incorreta e senhas incorretas.
STATUS_NO_LOGON_SERVERS
Nenhum controlador de domínio está disponível para atender à solicitação de autenticação.
STATUS_NO_SUCH_PACKAGE
O pacote de autenticação especificado não é reconhecido pela LSA.
[in] ntsSubstatus
Um inteiro que contém informações sobre por que uma tentativa de logon falhou. Esse valor será definido somente se as informações da conta do usuário forem válidas e o logon for rejeitado. Isso pode conter um dos valores a seguir.
STATUS_INVALID_LOGON_HOURS
A conta de usuário tem restrições de tempo e não pode ser usada para fazer logon no momento.
STATUS_INVALID_WORKSTATION
A conta de usuário tem restrições de estação de trabalho e não pode ser usada para fazer logon da estação de trabalho atual.
STATUS_PASSWORD_EXPIRED
A senha da conta de usuário expirou.
STATUS_ACCOUNT_DISABLED
A conta de usuário está desabilitada no momento e não pode ser usada para fazer logon.
[in] pszCaption
Um ponteiro para uma cadeia de caracteres que contém a caixa de mensagem legenda.
[in] pszMessage
Um ponteiro para uma cadeia de caracteres que contém a mensagem.
[in] uType
Um inteiro que contém o tipo de caixa de mensagem. Para obter mais informações, consulte a função MessageBox .
[out] pResponse
Um ponteiro para uma enumeração WRDS_LOGON_ERROR_REDIRECTOR_RESPONSE que especifica ao serviço de Serviços de Área de Trabalho Remota a resposta preferencial ao erro de logon.
Retornar valor
Quando você estiver implementando esse método, retorne S_OK se a função for bem-sucedida. Se falhar, retorne um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Windows |
| Cabeçalho | wtsprotocol.h |