DeleteAtom-Funktion (winbase.h)

Artikel
03/03/2024

Verringert die Verweisanzahl eines lokalen Zeichenfolgenatoms. Wenn die Referenzanzahl des Atoms auf null reduziert wird, entfernt DeleteAtom die dem Atom zugeordnete Zeichenfolge aus der lokalen Atomtabelle.

Syntax

ATOM DeleteAtom(
  [in] ATOM nAtom
);

Parameter

[in] nAtom

Typ: ATOM

Das zu löschende Atom.

Rückgabewert

Typ: ATOM

Wenn die Funktion erfolgreich ist, ist der Rückgabewert „0“.

Wenn die Funktion fehlschlägt, ist der Rückgabewert der nAtom-Parameter . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Verweisanzahl eines Zeichenfolgenatoms gibt an, wie oft das Atom der Atomtabelle hinzugefügt wurde. Die AddAtom-Funktion erhöht die Anzahl bei jedem Aufruf. Die DeleteAtom-Funktion verringert die Anzahl bei jedem Aufruf, entfernt die Zeichenfolge jedoch nur, wenn die Verweisanzahl des Atoms 0 ist.

Jeder Aufruf von AddAtom sollte einen entsprechenden Aufruf von DeleteAtom aufweisen. Rufen Sie DeleteAtom nicht öfter auf, als Sie AddAtom aufrufen, oder Sie können das Atom löschen, während andere Clients es verwenden.

Die DeleteAtom-Funktion hat keine Auswirkung auf ein ganzzahliges Atom (ein Atom, dessen Wert im Bereich liegt, der 0x0001 bis 0xBFFF). Die Funktion gibt für ein ganzzahliges Atom immer null zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll