International PHP Conference Berlin 2025

win32_start_service

(PECL win32service >=0.1.0)

win32_start_serviceStarts a service

Beschreibung

win32_start_service(string $servicename, string $machine = null): void

Attempts to start the named service. Requires administrative privileges or an account with appropriate rights set in the service's ACL.

Parameter-Liste

servicename

The short name of the service.

machine

Optional machine name. If omitted, the local machine is used.

Rückgabewerte

Es wird kein Wert zurückgegeben.

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

Fehler/Exceptions

A ValueError is thrown if the value of servicename parameter is empty.

A Win32ServiceException is thrown on error.

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.3.0 This function does not longer require an administrator account if ACL is set for another account.

Siehe auch

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top