DeleteAtom-Funktion (winbase.h)
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 |
Siehe auch
Referenz