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

Voir aussi

AddAtom

FindAtom

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

MAKEINTATOM

Référence