CreateWaitableTimerW |
kernel32.dll | Créer d'une horloge d'attente Unicode |
|---|---|---|
| Windows NT 4+, 2000, XP, 2003 | ||
Syntaxe
| HANDLE CreateWaitableTimerW( LPSECURITY_ATTRIBUTES lpTimerAttributes, BOOL bManualReset, LPCWSTR lpTimerName ); |
Paramètres
| Nom | Description | |
|---|---|---|
| lpTimerAttributes | Ce paramètre permet d'indiquer un pointeur sur une structure SECURITY_ATTRIBUTES spécifiant un descripteur de sécurité pour le nouvel objet de minuterie et détermine si les processus enfants peuvent hériter du descripteur renvoyé. Si le paramètre lpTimerAttributes a la valeur NULL, alors l'objet de minuterie reçoit un descripteur de sécurité par défaut et le descripteur ne peut pas être hérité. Les listes de contrôle d'accès dans le descripteur de sécurité par défaut d'un minuteur proviennent du jeton principal ou d'emprunt d'identité du créateur. | |
| bManualReset | Ce paramètre permet d'indiquer le comportement de la minuterie : | |
| Valeur | Description | |
| FALSE | Cette valeur permet d'indiquer que la minuterie est un minuteur de synchronisation. | |
| TRUE | Cette valeur permet d'indiquer que la minuterie est un minuteur d'avertissement à réinitialisation manuelle. | |
| lpTimerName | Ce paramètre permet d'indiquer le nom de l'objet de minuterie. Le nom est limité à MAX_PATH. La comparaison de noms est sensible à la casse. Si lpTimerName est NULL, l'objet de minuterie est créé sans nom. Si le paramètre lpTimerName correspond au nom d'un événement, d'un sémaphore, d'un mutex, d'un travail ou d'un objet de cartographie de fichier existant, la fonction échoue et GetLastError renvoie ERROR_INVALID_HANDLE. Cela est dû au fait que ces objets partagent le même espace de noms. Le nom peut avoir un préfixe «Global» ou «Local» pour créer explicitement l'objet dans l'espace de nom global ou de session. Le reste du nom peut contenir n'importe quel caractère sauf le caractère barre oblique inversée. | |
Description
Cette fonction permet d'effectuer la création d'une horloge de délai d'attente avec des paramètres de chaîne de caractères étendue (Unicode).
Remarques
- Le descripteur renvoyé par CreateWaitableTimerW est créé avec le droit d'accès TIMER_ALL_ACCESS; il peut être utilisé dans toute fonction nécessitant un gestionnaire pour un objet de minuterie, à condition que l'appelant en ait reçu l'accès. Si la minuterie est créé à partir d'un service ou d'un processus léger empruntant l'identité d'un utilisateur différent, vous pouvez appliquer un descripteur de sécurité à la minuterie lorsque vous le créez ou modifier le descripteur de sécurité par défaut du processus de création en modifiant sa DACL par défaut.
- Tout processus léger du processus appelant peut spécifier le descripteur d'objet de minuterie dans un appel à l'une des fonctions d'attente.
- Plusieurs processus peuvent avoir des descripteurs sur le même objet de minuterie, ceci permettant d'utiliser cet objet pour la synchronisation inter-processus. Un processus créé par la fonction CreateProcessW peut hériter d'un descripteur d'objet de minuterie si le paramètre lpTimerAttributes de CreateWaitableTimerW active l'héritage. Un processus peut spécifier le descripteur d'objet de minuterie dans un appel de la fonction DuplicateHandle. Le descripteur résultant peut être utilisé par un autre processus. Un processus peut spécifier le nom d'un objet de minuterie dans un appel de la fonction OpenWaitableTimerW ou CreateWaitableTimerW.
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Lundi, le 22 octobre 2018