GlobalFindAtom (Windows Embedded CE 6.0)

1/6/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 MAKEINTATOM macro.

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 GlobalFindAtom is not case-sensitive.

If you created the value of lpString by using the MAKEINTATOM macro, 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

See Also

Reference

Atoms Functions
GlobalAddAtom
GlobalDeleteAtom
MAKEINTATOM