win32_start_service_ctrl_dispatcher

(PECL win32service >=0.1.0)

win32_start_service_ctrl_dispatcherRegisters the script with the SCM, so that it can act as the service with the given name

Beschreibung

win32_start_service_ctrl_dispatcher(string $name, bool $gracefulMode = true): void

When launched via the Service Control Manager, a service process is required to "check-in" with it to establish service monitoring and communication facilities. This function performs the check-in by spawning a thread to handle the lower-level communication with the service control manager.

Once started, the service process should do 2 things. The first is to tell the Service Control Manager that the service is running. This is achieved by calling win32_set_service_status() with the WIN32_SERVICE_RUNNING constant. If you need to perform some lengthy process before the service is actually running, then you can use the WIN32_SERVICE_START_PENDING constant. The second is to continue to check-in with the service control manager so that it can determine if it should terminate. This is achieved by periodically calling win32_get_last_control_message() and handling the return code appropriately.

Achtung

Since version 0.2.0, this function work only in "cli" SAPI. On other SAPI this function is disabled.

Parameter-Liste

name

The short-name of the service, as registered by win32_create_service().

gracefulMode

true for exit graceful. false for exit with error. See win32_set_service_exit_mode() for more details.

Rückgabewerte

Es wird kein Wert zurückgegeben.

Prior to version 1.0.0, gab im Erfolgsfall WIN32_NO_ERROR zurück oder false, wenn es ein Problem mit den Parametern gab oder einen Win32-Fehlercode im Fehlerfall.

Fehler/Exceptions

Prior to version 1.0.0, if the SAPI is not "cli", this function emits an E_ERROR level error.

As of version 1.0.0, will throw a Win32ServiceException if SAPI is not "cli"

Changelog

Version Beschreibung
PECL win32service 1.0.0 Throws a ValueError on invalid data in parameters, previously false was returned.
PECL win32service 1.0.0 Throws a Win32ServiceException on error, previously a Win32 Error Code was returned.
PECL win32service 1.0.0 The return type is now void, previously it was mixed.
PECL win32service 0.4.0 The parameter gracefulMode has been added.
PECL win32service 0.2.0 This function works only in the "cli" SAPI.

Beispiele

Beispiel #1 A win32_start_service_ctrl_dispatcher() example

Check if the service is runnig under the SCM.

<?php
if (!win32_start_service_ctrl_dispatcher('dummyphp')) {
  die(
"I'm probably not running under the service control manager");
}

win32_set_service_status(WIN32_SERVICE_START_PENDING);

// Some lengthy process to get this service up and running.

win32_set_service_status(WIN32_SERVICE_RUNNING);

while (
WIN32_SERVICE_CONTROL_STOP != win32_get_last_control_message()) {
  
# do some work here, trying not to take more than around 30 seconds
  # before coming back into the loop again
}
?>

Siehe auch

Hier Kannst Du einen Kommentar verfassen


Bitte gib mindestens 10 Zeichen ein.
Wird geladen... Bitte warte.
* Pflichtangabe
Es sind noch keine Kommentare vorhanden.

Was genau bedeutet "Vibe Coding"? Ein tiefgehender Blick für Entwickler

In der Welt der Softwareentwicklung gibt es unzählige Wege, wie man an ein Projekt herangeht. Manche schwören auf strikte Planung, andere auf bewährte Algorithmen und wieder andere lassen sich von etwas ganz anderem leiten: ihrem Gefühl. ...

admin

Autor : admin
Kategorie: Software & Web-Development

PHP cURL-Tutorial: Verwendung von cURL zum Durchführen von HTTP-Anfragen

cURL ist eine leistungsstarke PHP-Erweiterung, die es Ihnen ermöglicht, mit verschiedenen Servern über verschiedene Protokolle wie HTTP, HTTPS, FTP und mehr zu kommunizieren. ...

TheMax

Autor : TheMax
Kategorie: PHP-Tutorials

Midjourney Tutorial - Anleitung für Anfänger

Über Midjourney, dem Tool zur Erstellung digitaler Bilder mithilfe von künstlicher Intelligenz, gibt es ein informatives Video mit dem Titel "Midjourney Tutorial auf Deutsch - Anleitung für Anfänger" ...

Mike94

Autor : Mike94
Kategorie: KI Tutorials

Tutorial veröffentlichen

Tutorial veröffentlichen

Teile Dein Wissen mit anderen Entwicklern weltweit

Du bist Profi in deinem Bereich und möchtest dein Wissen teilen, dann melde dich jetzt an und teile es mit unserer PHP-Community

mehr erfahren

Tutorial veröffentlichen

Kann man bei dem Programm MySQL Workbench Befehle anzeigen lassen?

Hallo, ich bringe gerade meinem Bruder MySQL bei, dafür nutze ich die MySQL Workbench Version 8.0.21, Version 6.3.10 & 6.3.7. Also ich kann auf d ...

Geschrieben von lessonadult am 06.05.2025 04:02:38
Forum: SQL / Datenbanken
Reise Gewinnspiel: Mit etwas Glück in den Traumurlaub starten

Ein Reise Gewinnspiel (https://gewinnspiele-in-deutschland.de/reise-gewinnspiele/) ist für viele Menschen der Inbegriff von Abenteuer, Fernweh un ...

Geschrieben von Codini am 05.05.2025 08:55:42
Forum: Off-Topic Diskussionen
CBD gegen Stress: Natürliche Hilfe für einen gelasseneren Alltag

In unserer schnelllebigen Welt ist Stress für viele Menschen zum Dauerbegleiter geworden. Termindruck, ständige Erreichbarkeit, familiäre Verpf ...

Geschrieben von Codini am 05.05.2025 08:41:56
Forum: Off-Topic Diskussionen
Zustrombegrenzungsgesetz: Steuerung und Kontrolle von Migration im Fokus der Politik

Das sogenannte Zustrombegrenzungsgesetz (https://magazin.webmasterplan.com/wissen-ratgeber/zustrom-begrenzung-gesetz/) ist ein politisches und rec ...

Geschrieben von Codini am 04.05.2025 10:15:59
Forum: Off-Topic Diskussionen