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