win32_delete_service

(PECL win32service >=0.1.0)

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

说明

win32_delete_service(string $servicename, string $machine = ?): 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,以前是 mixed

范例

范例 #1 win32_delete_service() 的示例

删除 dummyphp 服务。

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

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top