GetClassInfo

The GetClassInfo function retrieves information about a window class.

The GetClassInfo function has been superseded by the GetClassInfoEx function. You can still use GetClassInfo, however, if you do not need information about the class small icon.

BOOL GetClassInfo(
  HINSTANCE hInstance,    // handle of application instance
  LPCTSTR lpClassName,    // address of class name string
  LPWNDCLASS lpWndClass   // address of structure for class data
);
 

Parameters

hInstance

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.

lpClassName

Pointer to a null-terminated string containing the class name. The name must be that of a preregistered class or a class registered by a previous call to the RegisterClass function. Alternatively, this parameter can be an integer atom. If so, it must be a global atom created by a previous call to the GlobalAddAtom function. The atom, a 16-bit value less than 0xC000, must be in the low-order word of lpClassName; the high-order word must be zero.

lpWndClass

Pointer to a WNDCLASS structure that receives the information about the class.

Return Values

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

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

Windows CE: If lpClassName is an atom, it must be an atom returned from RegisterClass.

See Also

Window Classes Overview, Window Class Functions, GetClassInfoEx, GetClassLong, GetClassName, GlobalAddAtom, RegisterClass, WNDCLASS