WTSOpenServerExW, fonction (wtsapi32.h)
Ouvre un handle sur le serveur hôte de session Bureau à distance (hôte de session Bureau à distance) ou l’hôte de virtualisation Bureau à distance (hôte de virtualisation bureau à distance).
Syntaxe
HANDLE WTSOpenServerExW(
[in] LPWSTR pServerName
);
Paramètres
[in] pServerName
Pointeur vers une chaîne terminée par null qui contient le nom NetBIOS du serveur.
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle pour le serveur spécifié.
Si la fonction échoue, elle retourne un handle non valide. Vous pouvez tester la validité du handle en l’utilisant dans un autre appel de fonction.
Remarques
Si le serveur spécifié par le paramètre pServerName est un serveur hôte de session Bureau à distance, le comportement de cette fonction est identique à celui de la fonction WTSOpenServer .
Pour utiliser des sessions en cours d’exécution sur des machines virtuelles sur le serveur hôte de virtualisation des services Bureau à distance sur lequel l’application appelante s’exécute, spécifiez WTS_CURRENT_SERVER_NAME pour le paramètre pServerName .
Une fois que vous avez terminé d’utiliser le handle retourné par cette fonction, relâchez-le en appelant la fonction WTSCloseServer .
Notes
L’en-tête wtsapi32.h définit WTSOpenServerEx 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. La combinaison 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.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 7 |
Serveur minimal pris en charge | Windows Server 2008 R2 |
Plateforme cible | Windows |
En-tête | wtsapi32.h |
Bibliothèque | Wtsapi32.lib |
DLL | Wtsapi32.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour