Checks whether a specific item on the task bar is selected.

integer AIT_TaskbarItemSelected  (
  integer nIndex      // Index
);

nIndex (input)

Specify the index of a task bar item. As the reference index is 1, the index for the first item is 1.

The return value is 1 if the task bar item is selected, 0 if not, and -1 if the function has not been processed normally. If -1 has been returned, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError may return.

Extended error number	Error code
6	ERROR_INVALID_HANDLE
8	ERROR_NOT_ENOUGH_MEMORY
14	ERROR_OUTOFMEMORY
1413	ERROR_INVALID_INDEX

You can use this function in Windows 2000, Windows NT 4.0, Windows Me, and Windows 98. You cannot use it in Windows 8, Windows Server 2012, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 and Windows XP.