nf-commctrl-createstatuswindoww.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:commctrl.CreateStatusWindowW	CreateStatusWindowW function (commctrl.h)	Creates a status window, which is typically used to display the status of an application. (Unicode)	CreateStatusWindow CreateStatusWindow function [Windows Controls] CreateStatusWindowW _win32_CreateStatusWindow _win32_CreateStatusWindow_cpp commctrl/CreateStatusWindow commctrl/CreateStatusWindowW controls.CreateStatusWindow controls._win32_CreateStatusWindow	controls\CreateStatusWindow.htm	Controls	VS|Controls|~\controls\status\functions\createstatuswindow.htm	12/05/2018	CreateStatusWindow, CreateStatusWindow function [Windows Controls], CreateStatusWindowA, CreateStatusWindowW, _win32_CreateStatusWindow, _win32_CreateStatusWindow_cpp, commctrl/CreateStatusWindow, commctrl/CreateStatusWindowA, commctrl/CreateStatusWindowW, controls.CreateStatusWindow, controls._win32_CreateStatusWindow	commctrl.h		Windows	Windows Vista [desktop apps only]	Windows Server 2003 [desktop apps only]				CreateStatusWindowW (Unicode) and CreateStatusWindowA (ANSI)						Comctl32.lib	Comctl32.dll		Windows			19H1	CreateStatusWindowW commctrl/CreateStatusWindowW	c++	APIRef kbSyntax	DllExport	Comctl32.dll	CreateStatusWindow CreateStatusWindowA CreateStatusWindowW

CreateStatusWindowW function

-description

Creates a status window, which is typically used to display the status of an application. The window generally appears at the bottom of the parent window, and it contains the specified text.

Note   This function is obsolete. Use CreateWindow instead.

 

-parameters

-param style

Type: LONG

Window styles for the status window. This parameter must include the WS_CHILD style and should also include the WS_VISIBLE style.

-param lpszText

Type: LPCTSTR

Pointer to a null-terminated string that specifies the status text for the first part.

-param hwndParent

Type: HWND

handle to the parent window.

-param wID

Type: UINT

Control identifier for the status window. The window procedure uses this value to identify messages it sends to the parent window.

-returns

Type: HWND

Returns the handle to the status window if successful, or NULL otherwise. To retrieve extended error information, call GetLastError.

-remarks

The CreateStatusWindow function calls the CreateWindow function to create the window. It passes the parameters to without modification and sets the position, width, and height parameters to CreateWindow default values.

Note

The commctrl.h header defines CreateStatusWindow as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.