Edit Report a Bug

    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 = ?): 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.

    add a note add a note

    User Contributed Notes 1 note

    up
    1
    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 add a note
    To Top