win32_delete_service

(PECL win32service >=0.1.0)

win32_delete_service — 從 SCM 資料庫中刪除服務項目

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

嘗試從 SCM 資料庫中刪除服務。必須擁有管理員權限才能成功執行此操作。

此函式實際上只是將服務標記為刪除。如果有其他程序 (例如「服務」應用程式) 開啟，則刪除操作將會延遲到這些應用程式關閉後才會執行。如果服務被標記為刪除，則進一步嘗試刪除該服務將會失敗，並且嘗試使用該名稱建立新服務也會失敗。

不傳回任何值。

在 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');
?>

此頁面沒有使用者貢獻的註解。