Partager via


énumération WTS_INFO_CLASS (wtsapi32.h)

Contient des valeurs qui indiquent le type d’informations de session à récupérer dans un appel à la fonction WTSQuerySessionInformation .

Syntaxe

typedef enum _WTS_INFO_CLASS {
  WTSInitialProgram,
  WTSApplicationName,
  WTSWorkingDirectory,
  WTSOEMId,
  WTSSessionId,
  WTSUserName,
  WTSWinStationName,
  WTSDomainName,
  WTSConnectState,
  WTSClientBuildNumber,
  WTSClientName,
  WTSClientDirectory,
  WTSClientProductId,
  WTSClientHardwareId,
  WTSClientAddress,
  WTSClientDisplay,
  WTSClientProtocolType,
  WTSIdleTime,
  WTSLogonTime,
  WTSIncomingBytes,
  WTSOutgoingBytes,
  WTSIncomingFrames,
  WTSOutgoingFrames,
  WTSClientInfo,
  WTSSessionInfo,
  WTSSessionInfoEx,
  WTSConfigInfo,
  WTSValidationInfo,
  WTSSessionAddressV4,
  WTSIsRemoteSession
} WTS_INFO_CLASS;

Constantes

 
WTSInitialProgram
Chaîne terminée par null qui contient le nom du programme initial exécuté par les services Bureau à distance lorsque le
l’utilisateur se connecte.
WTSApplicationName
Chaîne terminée par null qui contient le nom publié de l’application en cours d’exécution de la session.

Windows Server 2008 R2, Windows 7, Windows Server 2008 et Windows Vista : Cette valeur n’est pas prise en charge
WTSWorkingDirectory
Chaîne terminée par null qui contient le répertoire par défaut utilisé lors du lancement du programme initial.
WTSOEMId
Cette valeur n'est pas utilisée.
WTSSessionId
Valeur ULONG qui contient l’identificateur de session.
WTSUserName
Chaîne terminée par null qui contient le nom de l’utilisateur associé à la session.
WTSWinStationName
Chaîne terminée par null qui contient le nom de la session services Bureau à distance.

Note Malgré son nom, la spécification de ce type ne retourne pas le nom de la station de fenêtre. Au lieu de cela, il retourne le
nom de la session services Bureau à distance. Chaque session des services Bureau à distance est associée à une fenêtre interactive
Station. Étant donné que le seul nom de station de fenêtre pris en charge pour une station de fenêtre interactive est
« WinSta0 », chaque session est associée à sa propre station de fenêtre « WinSta0 ». Pour plus d'informations, consultez la rubrique
Fenêtres.

 
WTSDomainName
Chaîne terminée par null qui contient le nom du domaine auquel appartient l’utilisateur connecté.
WTSConnectState
État de connexion actuel de la session. Pour plus d'informations, consultez la rubrique
WTS_CONNECTSTATE_CLASS.
WTSClientBuildNumber
Valeur ULONG qui contient le numéro de build du client.
WTSClientName
Chaîne terminée par null qui contient le nom du client.
WTSClientDirectory
Chaîne terminée par null qui contient le répertoire dans lequel le client est installé.
WTSClientProductId
Identificateur de produit spécifique au client USHORT .
WTSClientHardwareId
Valeur ULONG qui contient un identificateur matériel spécifique au client. Cette option est réservée à une utilisation ultérieure. WTSQuerySessionInformation retourne toujours une valeur de 0.
WTSClientAddress
Type de réseau et adresse réseau du client. Pour plus d'informations, consultez la rubrique
WTS_CLIENT_ADDRESS.

L’adresse IP est décalée de deux octets à partir du début du membre Address du WTS_CLIENT_ADDRESS
Structure.
WTSClientDisplay
Informations sur la résolution d’affichage du client. Pour plus d'informations, consultez la rubrique
WTS_CLIENT_DISPLAY.
WTSClientProtocolType
Valeur USHORT qui spécifie des informations sur le type de protocole pour le
Session. Il s’agit de l’une des valeurs suivantes.


















ValeurSignification

0


Session de console.


1


Cette valeur est conservée à des fins héritées.


2


Protocole RDP.

WTSIdleTime
Cette valeur retourne FALSE. Si vous appelez GetLastError pour obtenir des informations d’erreur étendues, GetLastError retourne ERROR_NOT_SUPPORTED.

Pour caculer le temps d’inactivité de session, utilisez le champ de structure LastInputTime .

Windows Server 2008 et Windows Vista : Cette valeur n’est pas utilisée.
WTSLogonTime
Cette valeur retourne FALSE. Si vous appelez GetLastError pour obtenir des informations d’erreur étendues, GetLastError retourne ERROR_NOT_SUPPORTED.

Windows Server 2008 et Windows Vista : Cette valeur n’est pas utilisée.
WTSIncomingBytes
Cette valeur retourne FALSE. Si vous appelez GetLastError pour obtenir des informations d’erreur étendues, GetLastError retourne ERROR_NOT_SUPPORTED.

Windows Server 2008 et Windows Vista : Cette valeur n’est pas utilisée.
WTSOutgoingBytes
Cette valeur retourne FALSE. Si vous appelez GetLastError pour obtenir des informations d’erreur étendues, GetLastError retourne ERROR_NOT_SUPPORTED.

Windows Server 2008 et Windows Vista : Cette valeur n’est pas utilisée.
WTSIncomingFrames
Cette valeur retourne FALSE. Si vous appelez GetLastError pour obtenir des informations d’erreur étendues, GetLastError retourne ERROR_NOT_SUPPORTED.

Windows Server 2008 et Windows Vista : Cette valeur n’est pas utilisée.
WTSOutgoingFrames
Cette valeur retourne FALSE. Si vous appelez GetLastError pour obtenir des informations d’erreur étendues, GetLastError retourne ERROR_NOT_SUPPORTED.

Windows Server 2008 et Windows Vista : Cette valeur n’est pas utilisée.
WTSClientInfo
Informations sur un client de connexion Bureau à distance (RDC). Pour plus d’informations, consultez WTSCLIENT.
WTSSessionInfo
Informations sur une session cliente sur un serveur hôte de session Bureau à distance. Pour plus d’informations, consultez WTSINFO.
WTSSessionInfoEx
Informations étendues sur une session sur un serveur hôte de session Bureau à distance. Pour plus d’informations, consultez WTSINFOEX.

Windows Server 2008 et Windows Vista : Cette valeur n’est pas prise en charge.
WTSConfigInfo
Structure WTSCONFIGINFO qui contient des informations sur la configuration d’un serveur hôte de session Bureau à distance.

Windows Server 2008 et Windows Vista : Cette valeur n’est pas prise en charge.
WTSValidationInfo
Cette valeur n’est pas prise en charge.
WTSSessionAddressV4
Structure WTS_SESSION_ADDRESS qui contient l’adresse IPv4 affectée à la session.
Si la session n’a pas d’adresse IP virtuelle, la fonction WTSQuerySessionInformation retourne ERROR_NOT_SUPPORTED.

Windows Server 2008 et Windows Vista : Cette valeur n’est pas prise en charge.
WTSIsRemoteSession
Détermine si la session active est une session à distance. La fonction WTSQuerySessionInformation retourne la valeur TRUE pour indiquer que la session active est une session à distance, et FALSE pour indiquer que la session active est une session locale. Cette valeur ne peut être utilisée que pour l’ordinateur local. Par conséquent, le paramètre hServer de la fonction WTSQuerySessionInformation doit contenir WTS_CURRENT_SERVER_HANDLE.

Windows Server 2008 et Windows Vista : Cette valeur n’est pas prise en charge.

Configuration requise

   
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
En-tête wtsapi32.h

Voir aussi

WTSQuerySessionInformation