DeleteAtom, fonction (winbase.h)
Décrémente le nombre de références d’un atome de chaîne local. Si le nombre de références de l’atome est réduit à zéro, DeleteAtom supprime la chaîne associée à l’atome de la table d’atomes locale.
Syntaxe
ATOM DeleteAtom(
[in] ATOM nAtom
);
Paramètres
[in] nAtom
Type : ATOM
Atome à supprimer.
Valeur retournée
Type : ATOM
Si la fonction aboutit, la valeur de retour est égale à zéro.
Si la fonction échoue, la valeur de retour est le paramètre nAtom . Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Le nombre de références d’un atome de chaîne spécifie le nombre de fois où l’atome a été ajouté à la table d’atomes. La fonction AddAtom incrémente le nombre sur chaque appel. La fonction DeleteAtom décrémente le nombre sur chaque appel, mais supprime la chaîne uniquement si le nombre de références de l’atome est égal à zéro.
Chaque appel à AddAtom doit avoir un appel correspondant à DeleteAtom. N’appelez pas DeleteAtom plus de fois que vous n’appelez AddAtom, ou vous pouvez supprimer l’atome pendant que d’autres clients l’utilisent.
La fonction DeleteAtom n’a aucun effet sur un atome entier (un atome dont la valeur se trouve dans la plage 0x0001 à 0xBFFF). La fonction retourne toujours zéro pour un atome entier.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |
Voir aussi
Référence