GlobalAddAtomExA-Funktion (winbase.h)

Artikel
11/20/2024

Fügt der globalen Atomtabelle eine Zeichenfolge hinzu und gibt einen eindeutigen Wert (ein Atom) zurück, der die Zeichenfolge identifiziert.

Syntax

ATOM GlobalAddAtomExA(
  [in, optional] LPCSTR lpString,
  [in]           DWORD  Flags
);

Parameter

[in, optional] lpString

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.

[in] Flags

Rückgabewert

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

Anmerkung

Der winbase.h-Header definiert GlobalAddAtomEx 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
Zielplattform-	Fenster
Header-	winbase.h (enthalten Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll

Siehe auch

GlobalAddAtom

Freigeben über