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

기타