UDF > WinAPIEx > System > Station & Desktop >


_WinAPI_CreateWindowStation

Crée un objet station window, l'associe avec le processus appelant, et l'affecte à la session en cours

#include <WinAPISys.au3>
_WinAPI_CreateWindowStation ( [$sName = '' [, $iAccess = 0 [, $iFlags = 0 [, $tSecurity = 0]]]] )

Paramètres

$sName [optionnel] Le nom de la station window à créer. Les noms des stations window sont insensibles à la casse et ne peuvent pas contenir de barre oblique inverse (\).
Seuls les membres du groupe Administrateurs sont autorisés à spécifier un nom.
Si ce paramètre est une chaîne vide (par défaut), le système forme un nom de station window en utilisant l'identifiant de la session de connexion pour le processus appelant.
$iAccess [optionnel] Le type d'accès que le handle retourné possède sur la station window. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes:
    $WINSTA_ALL_ACCESS
    $WINSTA_ACCESSCLIPBOARD
    $WINSTA_ACCESSGLOBALATOMS
    $WINSTA_CREATEDESKTOP
    $WINSTA_ENUMDESKTOPS
    $WINSTA_ENUMERATE
    $WINSTA_EXITWINDOWS
    $WINSTA_READATTRIBUTES
    $WINSTA_READSCREEN
    $WINSTA_WRITEATTRIBUTES
$iFlags [optionnel] Les flags optionnels. Peut être égal à zéro (par défaut) ou à la valeur suivante:
    $CWF_CREATE_ONLY
$tSecurity [optionnel] La structure $tagSECURITY_ATTRIBUTES qui détermine si le handle retourné peut être hérité par les processus enfants. Si ce paramètre est 0 (par défaut), le handle ne peut pas être hérité.

Valeur de retour

Succès: Retourne le handle de la station window nouvellement créée. Si la station de fenêtre spécifié existe déjà, la fonction réussit et retourne le handle de la station window existante.
Échec: Retourne 0, appelez _WinAPI_GetLastError() pour obtenir des informations sur l'erreur.

Remarque

Lorsque vous n'avez plus besoin du handle, vous devez appeler _WinAPI_CloseWindowStation() pour le libérer.

En relation

_WinAPI_CloseWindowStation

Voir aussi

Consultez CreateWindowStation dans la librairie MSDN.