The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

GetAltTabInfo function

Retrieves status information for the specified window if it is the application-switching (ALT+TAB) window.

Syntax

C++


BOOL WINAPI GetAltTabInfo(
  _In_opt_  HWND        hwnd,
  _In_      int         iItem,
  _Inout_   PALTTABINFO pati,
  _Out_opt_ LPTSTR      pszItemText,
  _In_      UINT        cchItemText
);

Parameters

hwnd [in, optional]

Type: HWND

A handle to the window for which status information will be retrieved. This window must be the application-switching window.

iItem [in]

Type: int

The index of the icon in the application-switching window. If the pszItemText parameter is not NULL, the name of the item is copied to the pszItemText string. If this parameter is –1, the name of the item is not copied.

pati [in, out]

Type: PALTTABINFO

A pointer to an ALTTABINFO structure to receive the status information. Note that you must set the csSize member to sizeof(ALTTABINFO) before calling this function.

pszItemText [out, optional]

Type: LPTSTR

The name of the item. If this parameter is NULL, the name of the item is not copied.

cchItemText [in]

Type: UINT

The size, in characters, of the pszItemText buffer.

Return value

Type:

Type: BOOL

If the function succeeds, the return value is nonzero.

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

Remarks

The application-switching window enables you to switch to the most recently used application window. To display the application-switching window, press ALT+TAB. To select an application from the list, continue to hold ALT down and press TAB to move through the list. Add SHIFT to reverse direction through the list.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll
Unicode and ANSI names	GetAltTabInfoW (Unicode) and GetAltTabInfoA (ANSI)