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

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

AIT_ExistWindow

Description

Checks whether the window exists which matches a specified window name and class name.

Format

integer AIT_ExistWindow  (
  string strWndCaption,     // Window's caption
  string strClassName       // Class name
  [,float fTimeOut]         // Time-out
);

Parameters

strWndCaption (input)

Specify the caption of a window.

strClassName (input)

Specify a window's class name.

fTimeOut (input, optional)

Specify the maximum time the function can use to find the control, in units of seconds. The default is the value set in the AIT_SetDefaultWaitTimeout function.

Return values

The return value is 1 if the window exists, and 0 if not. If the function has not been executed successfully, the return value is -1. 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
112 ERROR_DISK_FULL
1400 ERROR_INVALID_WINDOW_HANDLE
1460 ERROR_TIMEOUT