Job Management Partner 1/Software Distribution Automatic Installation Tool Description and Reference

[Contents][Glossary][Index][Back][Next]

AIT_TaskbarItemExists

Description

Checks whether the task bar contains a specific item.

Format

integer AIT_TaskbarItemExists  (
  integer nIndex      // Index
);

Parameters

nIndex (input)

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

Return values

The return value is 1 if the task bar item exists, 0 if not, and -1 if the function has not been processed successfully. 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
8 ERROR_NOT_ENOUGH_MEMORY
14 ERROR_OUTOFMEMORY
1400 ERROR_INVALID_WINDOW_HANDLE
1413 ERROR_INVALID_INDEX

Note

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.