AddAtomW-Funktion (winbase.h)
Fügt der lokalen Atomtabelle eine Zeichenfolge hinzu und gibt einen eindeutigen Wert (ein Atom) zurück, der die Zeichenfolge identifiziert.
Syntax
ATOM AddAtomW(
[in] LPCWSTR 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 nur im Fall unterschiedlich sind, werden als identisch betrachtet. Die Groß-/Kleinschreibung der ersten hinzugefügten Zeichenfolge wird beibehalten und von der funktion GetAtomName 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
Die AddAtom--Funktion speichert nicht mehr als eine Kopie einer bestimmten Zeichenfolge in der Atomtabelle. Wenn sich die Zeichenfolge bereits in der Tabelle befindet, gibt die Funktion das vorhandene Atom zurück und erhöht im Falle eines Zeichenfolgenatoms die Bezugsanzahl der Zeichenfolge.
Wenn lpString- das Format "#1234" aufweist, gibt AddAtom ein ganzzahliges 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 AddAtom ein Zeichenfolgenatom zurück.
Anmerkung
Der winbase.h-Header definiert AddAtom als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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-