I can't be responsible for any impact of your script or services you would run in production.
| _Services_UDF v4
| By Arcker
| Run your script as a service
| Req. AutoIt 126.96.36.199 min, last beta recommended ( tested in 188.8.131.52 )
<> Updated on 10/23/2013
<> Updated 07/29/2013
<> Best practices Updated 24/02/2012
-- Removed GUI code, and old codes.
== Warning : 26/02/2012
<> New Version (v3 ) : 29/07/2013
Thx to ShminkyBoy, wraithdu, Udgeen and HolmesShelock for their great contributions.
Special thx to bitboy,
see end of this post : services.rar
Here is my _Service _ UDF
With this UDF, you can compile your autoit script and run it as service.
Any comments are welcome.
Hope you'll like it,
1 - changelog
Update V4 : 23/10/2013
With the help of recent users i''ve recoded the whole engine to make it act really as a service.
A lot of bugs are corrected, ( stop issue ( not perfect but much better ) and _Main not executed sometimes )
Give it a try if you run older script with older version, you'll really see the difference.
Update : V3 on 29/07/2013
Engine script has been reworked. The only function you need now is Main.
All of the script is "hidden" in services.au3
Please don't touch it, every code you post must be from this original Services.au3
The bug concerning Win7 ( 1061 when stopping service ) is fixed.
All of the GUI related script has been removed. I don't support GUI creation, and since Win7, it's not more possible.
Remember to compile your script as CUI to avoid msgbox errors that would stop the service to be responsive.
The last version was a fusion of differents functions, and this was not a good idea at all.
Now it's back like v1.
The race condition kill service has been removed too. If your script fails when stopping it, please report it.
Update v2 : 02/03/2012
Now, see the updated example in page 1 to see the update. Respect the comments in code by not removing anything, and you service should run fine .... until stop
I'll maybe add an option to execute a thread that just the service to be stopped. I've to do this in C++ then use trancexx udf, but maybe it's possible, and will improve stop service feature
24/02/2012 added threadsafe advice
27/05/2011 Thread safe functions added. ServiceExample_ThreadSafe uploaded to this method.
added HolmesShelock examples.
11/01/2010 Updated with best practices
2 - Features
- Transform your application by adding few functions to make it compatible with SCM
3 - Known Issues.
4 - Howto.
- Compile the service example to see how to do then you can use the main function for your proper script
- Choose an appropriate location and copy the script here.
- open a command prompt, and execute the compiled script with option –I ( must be admin right since vista )
- start / execute "services.msc" . You will see a service called "Autoit_service". you can execute "sc query" in a command prompt too.
- Launch it : it will run the previous compile script. The main function will be executed after the service_init.
- stop and relaunch the service as you wish.
Main UDF V4 : See below
Examples / Session Change / uses v1 (lock, logon, etc) By HolmesShelock. Awesome work.
Edit : this example doesn't use v2 or v3 method
SessionChange Service.zip 67.75KB 3736 downloads
Example output to give you an idea
______________________________________ Log created: May 27, 2011 : 7:18:53 PM ______________________________________ May 27, 2011 : 7:18:53 PM  >> Service started: Sessionchange May 27, 2011 : 7:19:05 PM  >> cbSize = 8 ,dwSessionId = 0 May 27, 2011 : 7:19:05 PM  >> Session locked May 27, 2011 : 7:19:12 PM  >> cbSize = 8 ,dwSessionId = 0 May 27, 2011 : 7:19:12 PM  >> Console session disconnected May 27, 2011 : 7:19:12 PM  >> cbSize = 8 ,dwSessionId = 0 May 27, 2011 : 7:19:12 PM  >> Session unlocked May 27, 2011 : 7:19:12 PM  >> cbSize = 8 ,dwSessionId = 1 May 27, 2011 : 7:19:12 PM  >> Console session connected May 27, 2011 : 7:19:14 PM  >> cbSize = 8 ,dwSessionId = 1 May 27, 2011 : 7:19:14 PM  >> Session logged on May 27, 2011 : 7:19:38 PM  >> cbSize = 8 ,dwSessionId = 1 May 27, 2011 : 7:19:38 PM  >> Session locked May 27, 2011 : 7:19:40 PM  >> cbSize = 8 ,dwSessionId = 1 May 27, 2011 : 7:19:40 PM  >> Console session disconnected May 27, 2011 : 7:19:41 PM  >> cbSize = 8 ,dwSessionId = 0 May 27, 2011 : 7:19:41 PM  >> Console session connected May 27, 2011 : 7:19:41 PM  >> cbSize = 8 ,dwSessionId = 1
Edit : No more supported since v2
Provide install parameters and so on
by Spudw2k, optimised by myself to fit new code.
remove gui since no more supported in vista+, and not recommended.
Please don't ask for GUI.
ServiceMenu, by ShminkyBoy Note : only works on winxp, and no longer recommended. No support, and no question about it in this thread please.
Excellent example on how to make a GUI.
Updated to 0.3 by ShminkyBoy
And for End Users, I've tried to explain the service control manager and the way it works with programs.
Best Practice, by arcker :
/!\ please read this if you encounter stability issues
I've had to rework on services.au3 to reflect threadsafe.
Threadsafe means each dll call must be on "dllopened" instead of calling dll directly
for example, if you need a function in kernel32.dll, you have to open it and call it after.
That's contraignant since a lot of integrated functions in autoit are not programmed this way.
If you take my services.au3, at the end, you'll see reworked function to handle this change. I've not tried
services for a while, since i don't need it for now, but i can help you only if your provide whole script, to see how you call every functions.
I can tell that fix stability issues in callback, but i don't think it's need for your script, as far as you don't use callback.
Best Practice, by udgeen :
Good news! Probably i've found the working method of integrating service.au3 with other projects
I realised it after ASock.au3 project by Zatorg (please, sorry if im wrong) - ASock is asynck socket - tcp on event (uses ws2_32.dll).
Asock & sqlite didnt work together. The only reason for that was..._ArrayDisplay() func with gui!!! Ok. I made special sqlite.au3 without dependences. It works, but my udf seemed too be much heavy to use at another project.
Few weeks ago I returned to service.au3 and found TCP UDF, Event driven project based on ASock.au3. It seemed to work as example, but didn't work at all as service.
In my variant of service_example.au3 i posted msdn words about service_main procedure, that it must contain all global vars of project
I'll try to post that project as an another service_example.au3 in some weeks here. If it will works.
Some advice: use SysInternals Process Explorer (free gui based), or kill.exe from support tools to stop suspended service process. U can start-stop service even net start/net stop commands. Use file logging while debuging. No need to install-uninstall service after every recompilation: only stop, recompile, start. See, if it was suspended (while stopping) - kill process. The only reason not to stop service correctly i've found for today is unclean exit: opened sockets, maybe some dlls.
Edit : Arcker note: too bad, that would be too easy. unclean exit is not due to opened dll, but by some more internal exit checks or something.
1 - Hey, I've got error 1063 or error 0, what does that mean ?
It simply means that you intend to run your script in scite or directly by executing it.
Your script has to be installed as service and run from it. Several ways to do it :
- You have to combine all Globals in one place: for example at the the begining. You have to make it with other udfs too... silly work
- Then sort Global Const and other Global statements. If u see something like global $x = 1 do that way: global $x leeve at top. $x =1 insert into module's (udf or project) Init func.
- U have to do it even with standart udf... or use only necessary functions from it in your own include. Or... maybe u have another plan?
- Try to build your project with modified udfs - does it works now? Hmm... But it have to Maybe later after everything will work fine i'll say "msdn is wrong, microsoft lies"... But maybe i'll say that microsoft - is not so bad, because autoit works in it
- net start "yourservicename"
- Use API provided _Service_start, Service_stop.
2 - I want to make a GUI !
It's not possible in a service.
3 - I've to let the main function that way ? That's contraignant.
Hey, a script intended to run as service is special no ? Autoit is not C++. The only way to have a "Main" in autoit is to have a function.
If you find another way, please share it
Edited by arcker, 23 October 2013 - 12:33 PM.