GlobalFindAtomA-Funktion (winbase.h)
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 |
Siehe auch
Referenz