[edit] Last updated: Fri, 25 May 2012

win32_get_last_control_message

(PECL win32service SVN)

win32_get_last_control_message — Retourne le dernier message de contrôle qui a été envoyé à ce service

Description

int win32_get_last_control_message ( void )

Retourne le code de contrôle qui a été envoyé en dernier à ce processus de service. Lorsqu'il fonctionne en tant que service, vous devriez vérifier périodiquement pour déterminer si le service doit être arrêté.

Valeurs de retour

Retourne une constante de contrôle qui sera une parmi les constantes de contrôle des messages de service Win32Service : WIN32_SERVICE_CONTROL_CONTINUE, WIN32_SERVICE_CONTROL_INTERROGATE, WIN32_SERVICE_CONTROL_PAUSE, WIN32_SERVICE_CONTROL_PRESHUTDOWN, WIN32_SERVICE_CONTROL_SHUTDOWN, WIN32_SERVICE_CONTROL_STOP.

Voir aussi

win32_start_service_ctrl_dispatcher() - Enregistre un script avec SCM, alors il peut être interprété en tant que service avec le nom donné
les constantes de contrôle des messages de service Win32Service

add a note User Contributed Notes win32_get_last_control_message

kermodebea at kermodebear dot Oh Are Gee 02-May-2006 11:35


The definitions of some of these control codes can be found here (URL broken due to comment system, sorry about that!): http://msdn.microsoft.com/library

/default.asp?url=/library/en-us/dllproc/base/handler.asp



However, for your convenience (and mine):

SERVICE_CONTROL_STOP, 0x00000001

Notifies a service that it should stop.



If a service accepts this control code, it must stop upon receipt. After the SCM sends this control code, it does not send other control codes.



Windows XP/2000:  If the service returns NO_ERROR and continues to run, it continues to receive control codes. This behavior changed starting with Windows Server 2003 and Windows XP SP2.



SERVICE_CONTROL_PAUSE, 0x00000002

Notifies a service that it should pause.

(Although I guess that there is no requirement that you must.)



SERVICE_CONTROL_CONTINUE, 0x00000003

Notifies a paused service that it should resume.



SERVICE_CONTROL_INTERROGATE, 0x00000004

Notifies a service that it should report its current status information to the service control manager.

(I'm guessing that a call to win32_set_service_status() would satisfy interrogation?)



SERVICE_CONTROL_SHUTDOWN, 0x00000005

Notifies a service that the system is shutting down so the service can perform cleanup tasks.

add a note