GlobalFindAtomA-Funktion (winbase.h)

Artikel
08/27/2023

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

Syntax

ATOM GlobalFindAtomA(
  [in] LPCSTR lpString
);

Parameter

[in] lpString

Typ: LPCTSTR

Die NULL-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 in den Hinweisen.

Rückgabewert

Typ: ATOM

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das globale 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 beibehalten, wie sie ursprünglich eingegeben wurde, wird bei der von GlobalFindAtom durchgeführten Suche 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 GlobalFindAtom 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