GlobalDeleteAtom, fonction (winbase.h)

Article
03/03/2024

Décrémente le nombre de références d’un atome de chaîne globale. Si le nombre de références de l’atome atteint zéro, GlobalDeleteAtom supprime la chaîne associée à l’atome de la table globale des atomes.

Syntaxe

ATOM GlobalDeleteAtom(
  [in] ATOM nAtom
);

Paramètres

[in] nAtom

Type : ATOM

Atome et chaîne de caractères à supprimer.

Valeur retournée

Type : ATOM

La fonction retourne toujours (ATOM) 0.

Pour déterminer si la fonction a échoué, appelez SetLastError avec ERROR_SUCCESS avant d’appeler GlobalDeleteAtom, puis appelez GetLastError. Si le dernier code d’erreur est toujours ERROR_SUCCESS, GlobalDeleteAtom a réussi.

Remarques

Le nombre de références d’un atome de chaîne spécifie le nombre de fois où la chaîne a été ajoutée à la table d’atomes. La fonction GlobalAddAtom incrémente le nombre de références d’une chaîne qui existe déjà dans la table d’atomes globale chaque fois qu’elle est appelée.

Chaque appel à GlobalAddAtom doit avoir un appel correspondant à GlobalDeleteAtom. N’appelez pas GlobalDeleteAtom plus de fois que vous appelez GlobalAddAtom, sinon vous pouvez supprimer l’atome pendant que d’autres clients l’utilisent. Les applications utilisant Dynamic Data Exchange (DDE) doivent suivre les règles de gestion globale des atomes pour éviter les fuites et les suppressions prématurées.

GlobalDeleteAtom 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.

Exemples

Pour obtenir un exemple, consultez Lancement d’une conversation.

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