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