OpenWindowStationA, fonction (winuser.h)
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 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) |