PHP Conference Japan 2024

win32_delete_service

(PECL win32service >=0.1.0)

win32_delete_service从 SCM 数据库中删除服务条目

描述

win32_delete_service(字符串 $servicename, 字符串 $machine = null): void

尝试从 SCM 数据库中删除服务。此操作需要管理员权限才能成功。

此函数实际上只是将服务标记为要删除。如果其他进程(例如“服务”小程序)处于打开状态,则删除操作将推迟到这些应用程序关闭后进行。如果服务被标记为要删除,则进一步尝试删除它将失败,并且尝试使用该名称创建新服务也将失败。

参数

servicename

服务的简称。

machine

可选的机器名称。如果省略,则将使用本地机器。

返回值

不返回值。

在 1.0.0 版本之前,如果成功则返回 WIN32_NO_ERROR,如果参数有问题则返回 false,如果失败则返回 Win32 错误代码

错误/异常

如果 servicename 参数的值为空,则会抛出 ValueError 异常。

如果发生错误,则会抛出 Win32ServiceException 异常。

变更日志

版本 描述
PECL win32service 1.0.0 如果参数中的数据无效,则会抛出 ValueError 异常,以前返回 false
PECL win32service 1.0.0 如果发生错误,则会抛出 Win32ServiceException 异常,以前返回 Win32 错误代码
PECL win32service 1.0.0 返回值类型现在是 void,以前是 混合

范例

示例 #1 win32_delete_service() 示例

删除 dummyphp 服务。

<?php
win32_delete_service
('dummyphp');
?>

参见

添加注释

用户贡献的笔记

此页面没有用户贡献的笔记。
To Top