GlobalDeleteAtom-Funktion (winbase.h)

Artikel
03/06/2024

Verringert die Verweisanzahl eines globalen Zeichenfolgenatoms. Wenn die Verweisanzahl des Atoms null erreicht, entfernt GlobalDeleteAtom die dem Atom zugeordnete Zeichenfolge aus der globalen Atomtabelle.

Syntax

ATOM GlobalDeleteAtom(
  [in] ATOM nAtom
);

Parameter

[in] nAtom

Typ: ATOM

Das Zu löschende Atom und die zu löschende Zeichenfolge.

Rückgabewert

Typ: ATOM

Die Funktion gibt immer (ATOM) 0 zurück.

Um festzustellen, ob die Funktion fehlgeschlagen ist, rufen Sie SetLastError mit ERROR_SUCCESS auf, bevor Sie GlobalDeleteAtom aufrufen, und rufen Sie dann GetLastError auf. Wenn der letzte Fehlercode noch ERROR_SUCCESS ist, ist GlobalDeleteAtom erfolgreich.

Hinweise

Die Verweisanzahl eines Zeichenfolgenatoms gibt an, wie oft die Zeichenfolge der Atomtabelle hinzugefügt wurde. Die GlobalAddAtom-Funktion erhöht bei jedem Aufruf die Verweisanzahl einer Zeichenfolge, die bereits in der globalen Atomtabelle vorhanden ist.

Jeder Aufruf von GlobalAddAtom sollte einen entsprechenden Aufruf von GlobalDeleteAtom aufweisen. Rufen Sie GlobalDeleteAtom nicht häufiger auf, als Sie GlobalAddAtom aufrufen, oder Sie können das Atom löschen, während andere Clients es verwenden. Anwendungen, die dynamischen Datenaustausch (Dynamic Data Exchange, DDE) verwenden, sollten die Regeln für die globale Atomverwaltung befolgen, um Lecks und vorzeitiges Löschen zu verhindern.

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

Beispiele

Ein Beispiel finden Sie unter Initiieren einer Unterhaltung.

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 (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll