Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function searches the global atom table for the specified character string and retrieves the global atom associated with that string.

Syntax 

ATOM GlobalFindAtom(
  LPCTSTR 
lpString
);

Parameters

lpString

[in] Pointer to the null-terminated character string for which you want to search, or an integer atom you have converted to a string by using the MAKEINTATOMmacro.

Return Value

The global atom associated with the given string indicates success. 0 indicated failure. To get extended error information, call GetLastError.

Remarks

Even though the operating system preserves the case of a string in an atom table as it was originally entered, the search performed by GlobalFindAtomis not case-sensitive.

If you created the value of lpStringby using the MAKEINTATOMmacro, the low-order word must be in the range 0x0001 through 0xBFFF. If the low-order word is not in this range, the function fails.

Requirements

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also