win32_get_last_control_message

(PECL win32service >=0.1.0)

win32_get_last_control_message — Hizmete gönderilmiş son denetim kodunu döndürür

Açıklama

win32_get_last_control_message(): int

Bu hizmet sürecine gönderilmiş son denetim kodunu döndürür. Bir hizmet olarak çalışma sırasında sürecin durup durmadığını saptamak için bu denetimi belirli aralıklarla yapmalısınız.

Dikkat

0.2.0 sürümünden beri, bu işlev sadece "cli" SAPI ile çalışır. Diğer SAPI'lerde bu işlev devre dışıdır.

Bağımsız Değişkenler

Bu işlevin bağımsız değişkeni yoktur.

Dönen Değerler

Win32Service Hizmet Denetim İletisi Sabitlerinden biri döner: WIN32_SERVICE_CONTROL_CONTINUE, WIN32_SERVICE_CONTROL_DEVICEEVENT, WIN32_SERVICE_CONTROL_HARDWAREPROFILECHANGE, WIN32_SERVICE_CONTROL_INTERROGATE, WIN32_SERVICE_CONTROL_NETBINDADD, WIN32_SERVICE_CONTROL_NETBINDDISABLE, WIN32_SERVICE_CONTROL_NETBINDENABLE, WIN32_SERVICE_CONTROL_NETBINDREMOVE, WIN32_SERVICE_CONTROL_PARAMCHANGE, WIN32_SERVICE_CONTROL_PAUSE, WIN32_SERVICE_CONTROL_POWEREVENT, WIN32_SERVICE_CONTROL_PRESHUTDOWN, WIN32_SERVICE_CONTROL_SESSIONCHANGE, WIN32_SERVICE_CONTROL_SHUTDOWN, WIN32_SERVICE_CONTROL_STOP.

Değer 128 ile 255 arasındaysa, denetim kodu özeldir.

Hatalar/İstisnalar

1.0.0 öncesinde, SAPI "cli" değilse, bu işlev E_ERROR seviyesinde bir hata çıktılardı.

1.0.0 ve sonrasında, SAPI "cli" değilse, bu işlev Win32ServiceException yavrular.

Sürüm Bilgisi

Sürüm:	Açıklama
PECL win32service 1.0.0	Bağımsız değişkenlerdeki veri geçersiz ise artık ValueError yavrulanıyor, evvelce `false` dönerdi.
PECL win32service 1.0.0	Hata durumunda artık Win32ServiceException yavrulanıyor, evvelce bir Win32 Hata Kodu dönerdi.
PECL win32service 0.2.0	Bu işlev sadece `"cli"` SAPI ile çalışır.

Ayrıca Bakınız

win32_start_service_ctrl_dispatcher() - Hizmet yöneticisine ismi belirtilen hizmet gibi davranacak bir betik tanıtır
win32_set_service_status() - Hizmet durumunu günceller
win32_set_service_exit_mode() - Define or return the exit mode for the current running service
win32_set_service_exit_code() - Define or return the exit code for the current running service
Win32Service Hizmet Denetim İletisi Sabitleri

add a note

User Contributed Notes 1 note

down

kermodebea at kermodebear dot Oh Are Gee ¶

18 years ago


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