WTSOpenServerA, fonction (wtsapi32.h)
Ouvre un handle sur le serveur hôte de session Bureau à distance (hôte de session Bureau à distance) spécifié.
Syntaxe
HANDLE WTSOpenServerA(
[in] LPSTR pServerName
);
Paramètres
[in] pServerName
Pointeur vers une chaîne terminée par null spécifiant le nom NetBIOS du serveur hôte de session Bureau à distance.
Valeur de retour
Si la fonction réussit, la valeur de retour est un handle vers le serveur spécifié.
Si la fonction échoue, elle retourne un handle qui n’est pas valide. Vous pouvez tester la validité du handle en l’utilisant dans un autre appel de fonction.
Remarques
Lorsque vous avez terminé d’utiliser le handle retourné par WTSOpenServer, relâchez-le en appelant la fonction WTSCloseServer.
Vous n’avez pas besoin d’ouvrir un handle pour les opérations effectuées sur le serveur hôte de session Bureau à distance sur lequel votre application s’exécute. Utilisez plutôt la constante WTS_CURRENT_SERVER_HANDLE.
Note
L’en-tête wtsapi32.h définit WTSOpenServer 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 |