windows_programming_notes.nbk: Home | Index | Next Page: IsWindowEnabled | Previous Page: IsDlgButtonChecked

 IsWindow

The IsWindow function determines whether the specified window handle identifies an existing window.

Syntax

    BOOL IsWindow(
        HWND hWnd
        );

Parameters

• hWnd
  [in] Handle to the window to test.

Return Value

If the window handle identifies an existing window, the return value is nonzero.

If the window handle does not identify an existing window, the return value is zero.

Remarks

A thread should not use IsWindow for a window that it did not create because the window could be destroyed after this function was called. Further, because window handles are recycled the handle could even point to a different window.

Example

For an example, see Creating a Modeless Dialog Box.

Function Information

• Minimum DLL Version user32.dll
• Header Declared in Winuser.h, include Windows.h
• Import library User32.lib
• Minimum operating systems Windows 95, Windows NT 3.1
• Unicode Implemented as Unicode version.

windows_programming_notes.nbk: Home | Index | Next Page: IsWindowEnabled | Previous Page: IsDlgButtonChecked

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time