GlobalAddAtomExW-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 GlobalAddAtomExW(
[in, optional] LPCWSTR lpString,
[in] DWORD Flags
);
Parameter
[in, optional] lpString
Die hinzuzufügende NULL-Zeichenfolge. Die Zeichenfolge kann eine maximale Größe von 255 Bytes aufweisen. Zeichenfolgen, die sich nur für den Fall unterscheiden, dass sie als identisch gelten. Die Groß- und Kleinschreibung der ersten Zeichenfolge dieses Namens, die der Tabelle hinzugefügt wurde, wird beibehalten und von der GlobalGetAtomName-Funktion zurückgegeben.
Alternativ können Sie ein ganzzahliges Atom verwenden, das mit dem MAKEINTATOM-Makro 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 fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Hinweis
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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Zielplattform | Windows |
Kopfzeile | winbase.h (einschließlich Windows.h) |
Bibliothek | Kernel32.lib |
DLL | Kernel32.dll |
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für