FindWindow

The FindWindow function retrieves the handle to the top-level window whose class name and window name match the specified strings. This function does not search child windows.

At a Glance

Header file: Winuser.h
Windows CE versions: 1.0 and later

Syntax

HWND FindWindow( LPCTSTR lpClassName, LPCTSTR lpWindowName);

Parameters

lpClassName

Long pointer to a null-terminated string that specifies the class name or is an atom that identifies the class-name string. If this parameter is an atom, it must be a global atom created by a previous call to the GlobalAddAtom function. The atom, a 16-bit value, must be placed in the low-order word of lpClassName; the high-order word must be zero.

lpWindowName

Long pointer to a null-terminated string that specifies the window name (the window’s title). If this parameter is NULL, all window names match.

Return Values

A handle to the window that has the specified class name and window name indicates success. NULL indicates failure. To get extended error information, call GetLastError.

Remarks

If lpClassName is an atom, it must be an atom returned from RegisterClass.

See Also

GetClassName, HIWORD, RegisterClass