win32_query_service_status

(PECL win32service >=0.1.0)

win32_query_service_status — Bir hizmetin durumunu sorgular

win32_query_service_status(string$hizmet, string$makine = ?): array

Bir hizmetin mevcut durumunu sorgular ve sonucu bir dizi içinde döndürür.

hizmet: Hizmetin kısa ismi.
makine: İsteğe bağlı olarak makine ismi. Belirtilmezse yerel makine ismi kullanılır.

Başarı durumunda aşağıdaki bilgileri içeren bir dizi döner:

1.0.0 öncesinde, başarısızlık durumunda bağımsız değişkenlerle ilgili bir sorun varsa veya bir Win32 Hata Kodu sözkonusuysa false döner.

ServiceType: dwServiceType. Bkz: Win32Service Hizmet Türü Bit Maskeleri
CurrentState: dwCurrentState. Bkz: Win32Service Hizmet Durum Sabitleri.
ControlsAccepted: Hizmet tarafından kabul edilen hizmet denetimleri. Bkz: Win32Service Kabul Edilen Hizmet Denetim İletisi Bit Maskeleri.
Win32ExitCode: Hizmet çıkmışsa sürecin çıkış kodu. Çıkış kipi zarif değilse değeri WIN32_ERROR_SERVICE_SPECIFIC_ERROR sabitidir. Bkz: win32_set_service_exit_mode() ve Win32Service Hata Kodları.
ServiceSpecificExitCode: Hizmet bir hata koduyla çıkmışsa olay günlüğündeki hizmete özgü kod. Bu değer win32_set_service_exit_code() ile tanımlanan değerle aynıdır.
CheckPoint: Hizmet sonlanmışsa geçerli sınama sayısı. Bu hizmet yöneticisi tarafından kısıtlanan bir hizmet sürecini saptamak için bir kalp atışı tarzında kullanılır. Bu değer en iyi WaitHint değeriyle birlikte değerlendirilir.
WaitHint: Hizmet sonlanmışsa geçerli sınama sayısının tamamının kullanıldığını belirtmek üzere sınama sayısı. Bir süreç göstergesi oluşturmak için kullanılabilir.
ProcessId: Windows süreç kimliği. Sıfırsa süreç çalışmıyor demektir.
ServiceFlags: dwServiceFlags. Bkz: Win32Service Hizmet Bayrak Sabitleri.

servicename bağımsız değişkeni boşsa ValueError yavrulanır.

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 1.0.0	Dönüş türü artık array, evvelce mixed idi.