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

Improve This Page

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