CreateWindowStationW, fonction (winuser.h)
Crée un objet de station de fenêtre, l’associe au processus appelant et l’affecte à la session active.
Syntaxe
HWINSTA CreateWindowStationW(
[in, optional] LPCWSTR lpwinsta,
DWORD dwFlags,
[in] ACCESS_MASK dwDesiredAccess,
[in, optional] LPSECURITY_ATTRIBUTES lpsa
);
Paramètres
[in, optional] lpwinsta
Nom de la station de fenêtre à créer. Les noms des stations de fenêtre ne respectent pas la casse et ne peuvent pas contenir de caractères de barre oblique inverse (\). Seuls les membres du groupe Administrateurs sont autorisés à spécifier un nom. Si lpwinsta est NULL ou une chaîne vide, le système forme un nom de station de fenêtre à l’aide de l’identificateur de session d’ouverture de session pour le processus appelant. Pour obtenir ce nom, appelez la fonction GetUserObjectInformation.
dwFlags
Si ce paramètre est CWF_CREATE_ONLY et que la station de fenêtre existe déjà, l’appel échoue. Si cet indicateur n’est pas spécifié et que la station de fenêtre existe déjà, la fonction réussit et retourne un nouveau handle à la station de fenêtre existante.
Windows XP/2000 : Ce paramètre est réservé et doit être égal à zéro.
[in] dwDesiredAccess
Le type d’accès à la poignée retournée doit à la station de fenêtre. En outre, vous pouvez spécifier l’un des droits d’accès standard, tels que READ_CONTROL ou WRITE_DAC, et une combinaison des droits d’accès spécifiques à la station de fenêtre. Pour plus d’informations, consultez des droits d’accès et de sécurité de la station Window.
[in, optional] lpsa
Pointeur vers une structure SECURITY_ATTRIBUTES qui détermine si le handle retourné peut être hérité par les processus enfants. Si lpsa est NULL, le handle ne peut pas être hérité.
Le lpSecurityDescriptor membre de la structure spécifie un descripteur de sécurité pour la nouvelle station de fenêtre. Si lpsa est NULL, la station de fenêtre (et les bureaux créés dans la fenêtre) obtient un descripteur de sécurité qui accorde GENERIC_ALL accès à tous les utilisateurs.
Valeur de retour
Si la fonction réussit, la valeur de retour est un handle vers la station de fenêtre nouvellement créée. Si la station de fenêtre spécifiée existe déjà, la fonction réussit et retourne un handle à la station de fenêtre existante.
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 CreateWindowStation 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-l1-1-0 (introduit dans Windows 8) |