IsWindow function

Determines whether the specified window handle identifies an existing window.

Syntax

BOOL WINAPI IsWindow(
  _In_opt_ HWND hWnd
);

Parameters

hWnd [in, optional]

Type: HWND

A handle to the window to be tested.

Return value

Type:

Type: BOOL

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.

Examples

For an example, see Creating a Modeless Dialog Box.

Requirements

See also

Reference

IsWindowEnabled

IsWindowVisible

Conceptual

Windows