GlobalFindAtomA-Funktion (winbase.h)

Artikel
11/20/2024

Durchsucht die globale Atomtabelle nach der angegebenen Zeichenfolge und ruft das mit dieser Zeichenfolge verknüpfte globale Atom ab.

Syntax

ATOM GlobalFindAtomA(
  [in] LPCSTR lpString
);

Parameter

[in] lpString

Typ: LPCTSTR-

Die mit Null beendete Zeichenfolge, nach der gesucht werden soll.

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 globale Atom, das der angegebenen Zeichenfolge zugeordnet ist.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Obwohl das System die Groß-/Kleinschreibung einer Zeichenfolge in einer Atomtabelle bei der ursprünglichen Eingabe behält, wird bei der Suche, die von GlobalFindAtom durchgeführt wurde, die Groß-/Kleinschreibung nicht beachtet.

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.

Anmerkung

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 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