OpenWindowStationA, fonction (winuser.h)

  • Article

Ouvre la station de fenêtre spécifiée.

Syntaxe

HWINSTA OpenWindowStationA(
  [in] LPCSTR      lpszWinSta,
  [in] BOOL        fInherit,
  [in] ACCESS_MASK dwDesiredAccess
);

Paramètres

[in] lpszWinSta

Nom de la station de fenêtre à ouvrir. Les noms des stations de fenêtre ne respectent pas la casse.

Cette station de fenêtre doit appartenir à la session active.

[in] fInherit

Si cette valeur est TRUE, les processus créés par ce processus héritent du handle. Sinon, les processus n’héritent pas de ce handle.

[in] dwDesiredAccess

Accès à la station de fenêtre. Pour obtenir la liste des droits d’accès, consultez Sécurité et droits d’accès de la station Windows.

Valeur retournée

Si la fonction réussit, la valeur de retour est le handle de la station de fenêtre spécifiée.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Une fois que vous avez terminé avec le handle, vous devez appeler CloseWindowStation pour libérer le handle.

Notes

L’en-tête winuser.h définit OpenWindowStation en tant qu’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

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-windowstation-ansi-l1-1-1 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

CloseWindowStation

ExitWindows

ExitWindowsEx

Window Station et fonctions de bureau

Stations de fenêtre