ExampleCitrix Synchronization Functions

Checks if a window is visible on the screen.

int ctrx_win_exist( char *window_name, long waiting_time, [CONTINUE_ON_ERROR,] CTRX_LAST );

window_nameThe name of the window to check
waiting_time Indicates the timeout to wait, in seconds
CONTINUE_ON_ERROR A constant, entered as shown without quotes. Overrides the error behavior runtime setting for this step so that script behaves as though the runtime setting was Continue on error.
CTRX_LAST A marker that indicates the end of the argument list.

ctrx_win_exist returns E_OK (zero) if the window exists. The wildcard character (*) can be used in window_name.

Return Values

Citrix ICA Return Values


No parameterization is available for this function.


In the following example, ctrx_win_exist checks if the web browser has launched. If it doesn't appear within the specified waiting_time , ctrx_mouse_double_click launches the web browser from the desktop.

/* If browser has not launched in nine seconds, click the desktop IE icon */
if (!ctrx_win_exist("Welcome to MSN.com - Microsoft Internet Explorer", 9, CTRX_LAST))
ctrx_mouse_double_click(34, 325, LEFT_BUTTON, 0, NULL, CTRX_LAST);

ctrx_set_window("Welcome to MSN.com - Microsoft Internet Explorer", CTRX_LAST);

/* Exit the web browser by clicking on top left Exit check box */
ctrx_mouse_click(573, 61, LEFT_BUTTON, 0,
"Welcome to MSN.com - Microsoft Internet Explorer", CTRX_LAST);