GetClassInfoEx function

Retrieves information about a window class, including a handle to the small icon associated with the window class. The GetClassInfo function does not retrieve a handle to the small icon.

Syntax

BOOL WINAPI GetClassInfoEx(
  _In_opt_  HINSTANCE hinst,
  _In_      LPCTSTR lpszClass,
  _Out_     LPWNDCLASSEX lpwcx
);

Parameters

hinst [in, optional]

Type: HINSTANCE

A handle to the instance of the application that created the class. To retrieve information about classes defined by the system (such as buttons or list boxes), set this parameter to NULL.

lpszClass [in]

Type: LPCTSTR

The class name. The name must be that of a preregistered class or a class registered by a previous call to the RegisterClass or RegisterClassEx function. Alternatively, this parameter can be a class atom created by a previous call to RegisterClass or RegisterClassEx. The atom must be in the low-order word of lpszClass; the high-order word must be zero.

lpwcx [out]

Type: LPWNDCLASSEX

A pointer to a WNDCLASSEX structure that receives the information about the class.

Return value

Type:

Type: BOOL

If the function finds a matching class and successfully copies the data, the return value is nonzero.

If the function does not find a matching class and successfully copy the data, the return value is zero. To get extended error information, call GetLastError.

Remarks

Class atoms are created using the RegisterClass or RegisterClassEx function, not the GlobalAddAtom function.

Requirements

See also

Reference

GetClassLong

GetClassName

RegisterClass

RegisterClassEx

Conceptual

Window Classes

Send comments about this topic to Microsoft

Build date: 2/25/2013