Partager via


WTSActiveSessionExists, fonction (wtsapi32.h)

Retourne s’il existe une session active sur le système sans énumérer la liste des sessions. Il n’obtient pas non plus d’informations supplémentaires auprès du Gestionnaire de sessions locales.

Syntaxe

BOOL WTSActiveSessionExists(
  [out] PBOOL pbActiveSessionExists
);

Paramètres

[out] pbActiveSessionExists

Pointeur vers une valeur booléenne indiquant si une session active existe.

Valeur retournée

Retourne zéro si cette fonction échoue. Si cette fonction réussit, une valeur différente de zéro est retournée.

Remarques

Cette fonction détermine uniquement si une session active existe. Pour obtenir la liste des sessions et de leurs états, utilisez WTSEnumerateSessions. De nombreux processus s’exécutant dans la session 0 utilisent WTSEnumerateSessions pour vérifier si une session active existe ou pour effectuer des opérations si une session active existe (par exemple : obtenir le nom d’utilisateur, l’ID de session, etc.). L’utilisation de WTSEnumerateSessions lorsqu’aucune session active n’est coûteuse, car la liste complète des sessions inactives doit être énumérée.

Spécifications

Requirement Valeur
Client minimum requis Windows, version 26100
Header wtsapi32.h