WTSEnumerateServersA, fonction (wtsapi32.h)

Article
11/20/2024

Retourne la liste de tous les serveurs hôte de session Bureau à distance (hôte de session Bureau à distance) dans le domaine spécifié.

Syntaxe

BOOL WTSEnumerateServersA(
  [in] LPSTR             pDomainName,
  [in] DWORD             Reserved,
  [in] DWORD             Version,
       PWTS_SERVER_INFOA *ppServerInfo,
       DWORD             *pCount
);

Paramètres

[in] pDomainName

Pointeur vers le nom du domaine à interroger. Si la valeur de ce paramètre est NULL, le domaine spécifié est le domaine actuel.

[in] Reserved

Réservé. La valeur de ce paramètre doit être 0.

[in] Version

Version de la demande d’énumération. La valeur du paramètre doit être 1.

ppServerInfo

Pointe vers un tableau de structures WTS_SERVER_INFO, qui contient les résultats retournés de l’énumération. Après utilisation, la mémoire utilisée par cette mémoire tampon doit être libérée en appelant WTSFreeMemory.

pCount

Pointeur vers une variable qui reçoit le nombre de structures WTS_SERVER_INFO retournées dans la mémoire tampon ppServerInfo.

Valeur de retour

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Cette fonction ne fonctionnera pas si NetBT est désactivé.

Note

L’en-tête wtsapi32.h définit WTSEnumerateServers comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
serveur minimum pris en charge	Windows Server 2008
plateforme cible	Windows
d’en-tête	wtsapi32.h
bibliothèque	Wtsapi32.lib
DLL	Wtsapi32.dll

Voir aussi

WTS_SERVER_INFO

Partager via