Méthode IWTSProtocolLogonErrorRedirector::RedirectLogonError (wtsprotocol.h)
[IWTSProtocolLogonErrorRedirector::RedirectLogonError n’est plus disponible à partir de Windows Server 2012. Utilisez plutôt IWRdsProtocolLogonErrorRedirector::RedirectLogonError.]
Interroge le protocole pour connaître l’action à effectuer en réponse à une erreur d’ouverture de session. La méthode RedirectStatus est appelée par le service Services Bureau à distance pour interroger le protocole pour connaître l’action à effectuer en réponse à une erreur d’ouverture de session.
Syntaxe
HRESULT RedirectLogonError(
[in] LONG ntsStatus,
[in] LONG ntsSubstatus,
[in] LPCWSTR pszCaption,
[in] LPCWSTR pszMessage,
[in] UINT uType,
[out] WTS_LOGON_ERROR_REDIRECTOR_RESPONSE *pResponse
);
Paramètres
[in] ntsStatus
Entier qui contient des informations sur l’échec de l’ouverture de session. Il peut s’agir de l’une des valeurs suivantes.
STATUS_QUOTA_EXCEEDED
Le quota de mémoire est insuffisant pour allouer la mémoire tampon de sortie retournée par le package d’authentification.
STATUS_ACCOUNT_RESTRICTION
Le compte d’utilisateur et le mot de passe sont légitimes, mais le compte d’utilisateur a une restriction qui empêche l’ouverture de session pour l’instant. Pour plus d’informations, consultez le paramètre ntsSubstatus .
STATUS_BAD_VALIDATION_CLASS
Les informations d’authentification fournies ne sont pas reconnues par le package d’authentification.
STATUS_LOGON_FAILURE
La tentative d’ouverture de session a échoué. La raison de l’échec n’est pas spécifiée, mais les raisons courantes incluent des noms d’utilisateur mal orthographiés et des mots de passe mal orthographiés.
STATUS_NO_LOGON_SERVERS
Aucun contrôleur de domaine n’est disponible pour traiter la demande d’authentification.
STATUS_NO_SUCH_PACKAGE
Le package d’authentification spécifié n’est pas reconnu par LSA.
[in] ntsSubstatus
Entier qui contient des informations sur la raison de l’échec d’une tentative d’ouverture de session. Cette valeur est définie uniquement si les informations de compte de l’utilisateur sont valides et si l’ouverture de session est rejetée. Il peut contenir l’une des valeurs suivantes.
STATUS_INVALID_LOGON_HOURS
Le compte d’utilisateur a des restrictions de temps et ne peut pas être utilisé pour se connecter pour l’instant.
STATUS_INVALID_WORKSTATION
Le compte d’utilisateur a des restrictions de station de travail et ne peut pas être utilisé pour se connecter à partir de la station de travail actuelle.
STATUS_PASSWORD_EXPIRED
Le mot de passe du compte d’utilisateur a expiré.
STATUS_ACCOUNT_DISABLED
Le compte d’utilisateur est actuellement désactivé et ne peut pas être utilisé pour se connecter.
[in] pszCaption
Pointeur vers une chaîne qui contient la boîte de message légende.
[in] pszMessage
Pointeur vers une chaîne qui contient le message.
[in] uType
Entier qui contient le type de zone de message. Pour plus d’informations, consultez la fonction MessageBox .
[out] pResponse
Pointeur vers une énumération WTS_LOGON_ERROR_REDIRECTOR_RESPONSE qui spécifie au service Services Bureau à distance la réponse par défaut à l’erreur d’ouverture de session.
Valeur retournée
Lorsque vous implémentez cette méthode, retournez S_OK si la fonction réussit. En cas d’échec, retournez une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
Spécifications
Client minimal pris en charge | Aucun pris en charge |
Serveur minimal pris en charge | Windows Server 2008 R2 |
Plateforme cible | Windows |
En-tête | wtsprotocol.h |