GlobalAddAtomA-Funktion (winbase.h)
Fügt der globalen Atomtabelle eine Zeichenfolge hinzu und gibt einen eindeutigen Wert (ein Atom) zurück, der die Zeichenfolge identifiziert.
Syntax
ATOM GlobalAddAtomA(
[in] LPCSTR lpString
);
Parameter
[in] lpString
Typ: LPCTSTR-
Die zu hinzufügende NULL-Zeichenfolge. Die Zeichenfolge kann eine maximale Größe von 255 Byte aufweisen. Zeichenfolgen, die sich nur im Fall unterscheiden, werden als identisch betrachtet. Die Groß-/Kleinschreibung der ersten Zeichenfolge dieses Namens, die der Tabelle hinzugefügt wurde, wird beibehalten und von der funktion GlobalGetAtomName zurückgegeben.
Alternativ können Sie ein ganzzahliges Atom verwenden, das mithilfe des MAKEINTATOM Makros konvertiert wurde. Weitere Informationen finden Sie in den Hinweisen.
Rückgabewert
Typ: ATOM-
Wenn die Funktion erfolgreich ist, ist der Rückgabewert das neu erstellte Atom.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Wenn die Zeichenfolge bereits in der globalen Atomtabelle vorhanden ist, wird das Atom für die vorhandene Zeichenfolge zurückgegeben, und die Referenzanzahl des Atoms wird erhöht.
Die dem Atom zugeordnete Zeichenfolge wird erst aus dem Arbeitsspeicher gelöscht, wenn die Referenzanzahl null ist. Weitere Informationen finden Sie in der funktion GlobalDeleteAtom.
Globale Atome werden nicht automatisch gelöscht, wenn die Anwendung beendet wird. Für jeden Aufruf der GlobalAddAtom--Funktion muss ein entsprechender Aufruf der funktion GlobalDeleteAtom vorhanden sein.
Wenn der parameter lpString das Format "#1234" aufweist, gibt GlobalAddAtom einen ganzzahligen Atom zurück, dessen Wert die 16-Bit-Darstellung der in der Zeichenfolge angegebenen Dezimalzahl ist (0x04D2 in diesem Beispiel). Wenn der angegebene Dezimalwert 0x0000 oder größer oder gleich 0xC000 ist, ist der Rückgabewert null, was einen Fehler angibt. Wenn lpString- vom MAKEINTATOM Makro erstellt wurde, muss sich das Wort mit niedriger Reihenfolge im Bereich 0x0001 bis 0xBFFF befinden. Wenn sich das Wort in niedriger Reihenfolge nicht in diesem Bereich befindet, schlägt die Funktion fehl.
Wenn lpString- eine andere Form aufweist, gibt GlobalAddAtom ein Zeichenfolgenatom zurück.
Anmerkung
Der winbase.h-Header definiert GlobalAddAtom als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |
Siehe auch
Referenz-