Partager via


OpenWindowStationW, fonction (winuser.h)

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

Syntaxe

HWINSTA OpenWindowStationW(
  [in] LPCWSTR     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 de sécurité et de droits d’accès de Window Station.

Valeur de retour

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’erreur étendues, appelez GetLastError.

Remarques

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

Note

L’en-tête winuser.h définit OpenWindowStation 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 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Windows
d’en-tête winuser.h (include 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

station de fenêtre et fonctions de bureau

stations windows