win32service 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 Error Code를 반환했습니다.
오류/예외
servicename
매개변수의 값이 비어 있으면 ValueError가 발생합니다.
오류가 발생하면 Win32ServiceException이 발생합니다.
변경 로그
버전 | 설명 |
---|---|
PECL win32service 1.0.0 | 매개변수의 잘못된 데이터에 대해 ValueError를 발생시킵니다. 이전에는 false 가 반환되었습니다. |
PECL win32service 1.0.0 | 이전에 Win32 Error Code가 반환된 오류 시 Win32ServiceException을 throw합니다. |
PECL win32service 1.0.0 | 반환 유형은 이제 void이며 이전에는 mixed되었습니다. |
Examples
예제 #1 win32_delete_service() 예제
dummyphp 서비스를 삭제합니다.
<?php
win32_delete_service('dummyphp');
?>
기타
- win32_create_service() - SCM 데이터베이스에 새 서비스 항목을 생성합니다.
- Win32 Error Codes