Méthode IWTSProtocolLogonErrorRedirector::RedirectLogonError (wtsprotocol.h)

Article
08/28/2023

[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

Voir aussi

IWTSProtocolLogonErrorRedirector

Share via