win32_set_service_status

(PECL win32service >=0.1.0)

win32_set_service_statusHizmet durumunu günceller

Açıklama

win32_set_service_status(int$durum, int$denetim_noktası = 0): bool

Hizmet yöneticisine çalışan hizmetin durumu hakkında bilgi verir. Bu çağrı sadece çalışmakta olan hizmet süreçleri için geçerlidir.

Dikkat

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

Bağımsız Değişkenler

durum

Hizmet durum kodu. Şunlardan biri olmalıdır: WIN32_SERVICE_RUNNING, WIN32_SERVICE_STOPPED, WIN32_SERVICE_STOP_PENDING, WIN32_SERVICE_START_PENDING, WIN32_SERVICE_CONTINUE_PENDING, WIN32_SERVICE_PAUSE_PENDING, WIN32_SERVICE_PAUSED.

denetim_noktası

Denetim noktası değeri, hizmetin uzun bir başlatma, durdurma, duraklatma veya devam etme işlemi sırasında ilerlemesini bildirmek için düzenli aralıklarla artırdığı değerdir. Örneğin, hizmet başlatılırken başlatma işleminin her adımını tamamlandıkça bu değer artırılmalıdır.

denetim_noktası değerinin geçerli olabilmesi için durum şunlardan biri olmalıdır: WIN32_SERVICE_STOP_PENDING, WIN32_SERVICE_START_PENDING, WIN32_SERVICE_CONTINUE_PENDING, WIN32_SERVICE_PAUSE_PENDING.

Dönen Değerler

Hiçbir değer dönmez.

1.0.0 öncesinde, Başarı durumunda WIN32_NO_ERROR, 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.

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 yavruluyor.

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 void, evvelce mixed idi.
PECL win32service 0.2.0 Bu işlev sadece "cli" SAPI ile çalışır.

Ayrıca Bakınız

To Top