FindWindow

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.

The FindWindowfunction 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.

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 GlobalAddAtomfunction. 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 lpClassNameis an atom, it must be an atom returned from RegisterClass.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.0 and later	Winuser.h

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

GetClassName, HIWORD, RegisterClass