win32_query_service_status

(PECL win32service >=0.1.0)

win32_query_service_status — Bir hizmetin durumunu sorgular

Açıklama

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

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

Bağımsız Değişkenler

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

Dönen Değerler

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.

Hatalar/İstisnalar

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

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

Ayrıca Bakınız

Win32Service Öntanımlı Sabitler

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

demers dot alex at gmail dot com ¶

15 years ago

This function will return an array containing the above information as a return value, but if this fails it will return an integer which is a System Error Code. All the System Error Codes can be found here:

http://msdn.microsoft.com/en-us/library/ms681381%28VS.85%29.aspx

In my case, it returned 5, in which I immediately knew why and fixed the issue right away.

In the case of mnemotronic at netscape dot net, here in the documentation notes, it returned 1060 which is:

ERROR_SERVICE_DOES_NOT_EXIST
1060 (0x424)
The specified service does not exist as an installed service.

Again, it should not return FALSE, instead an System Error Code for Windows.

＋add a note