WinWaitActive and return codes

[chut7]

According to the documentation for WinWaitActive:

Return Value

Success: Returns handle to the requested window.

Failure: Returns 0 if timeout occurred.

However, on running this code:

$autoit->WinActivate("Windows Task Manager");
my $tmreturn=$autoit->WinWaitActive("Windows Task Manager","",10);
diag ("waiting for tm $tmreturn");
sleep (100);

I get the output,

# waiting for tm 1

It seems that it is just returning a true/false code, rather than the actual window handle. Is the documentation wrong?

I'm using 3.3.6.1 .

[guinness]

ConsoleWrite(WinWaitActive("Windows Task Manager") & @CRLF)

Returns a Handle for me! The documentation is correct.

Edit: Realised after JohnOne posted that this isn't an "Output" of your code but the code itself. I don't know how you got the output # waiting for tm 1??

Edited June 17, 2011 by guinness

[JohnOne]

Because that isnt autoit syntax, it wont give you any result, infact it wont run.

[chut7]

This is perl syntax, calling autoit through Watir. I suspect there's an old library that is being loaded up somewhere, as the changelog:

http://www.autoitscript.com/autoit3/docs/script_breaking_changes.htm

seems to indicate that what I'm seeing is old behaviour.

[JohnOne]

Not familiar with perl, but the function certainly works natively and I've used it in C++ and C#

There is a forum section Autoitx where you might get better help, if indeed that's what you are using.

[chut7]

Thanks all for your replies. Indeed, I am using AutoItX, so I pulled up the help for that and found this:

WinWaitActive "title", ["text"], [timeout]

Return Value

Success: Returns 1. 
Failure: Returns 0 if timeout occurred.

From this, it seems that the function in AutoItX has a different return value than AutoIt. I'll post a question in the AutoItX forum to confirm.