FindAtomA-Funktion (winbase.h)

Artikel
08/27/2023

Durchsucht die lokale Atomtabelle nach der angegebenen Zeichenfolge und ruft das Atom ab, das dieser Zeichenfolge zugeordnet ist.

Syntax

ATOM FindAtomA(
  [in] LPCSTR lpString
);

Parameter

[in] lpString

Typ: LPCTSTR

Die Zeichenfolge, nach der gesucht werden soll.

Alternativ können Sie ein ganzzahliges Atom verwenden, das mit dem MAKEINTATOM-Makro konvertiert wurde. Weitere Informationen finden Sie unter Hinweise.

Rückgabewert

Typ: ATOM

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Atom, das der angegebenen Zeichenfolge zugeordnet ist.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Obwohl das System die Groß-/Kleinschreibung einer Zeichenfolge in einer Atomtabelle behält, wird bei der Suche von der FindAtom-Funktion die Groß-/Kleinschreibung nicht beachtet.

Wenn lpString vom MAKEINTATOM-Makro erstellt wurde, muss sich das Wort mit niedriger Reihenfolge im Bereich befinden, der bis 0xBFFF 0x0001. Wenn sich das Wort mit niedriger Reihenfolge nicht in diesem Bereich befindet, schlägt die Funktion fehl.

Hinweis

Der winbase.h-Header definiert FindAtom 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


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 (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll