win32service win32_stop_service
(PECL win32service >=0.1.0)
win32_stop_service — 서비스 중지
설명
win32_stop_service(string $servicename
, string $machine
= ?): void
명명된 서비스를 중지합니다. 서비스의 ACL에 설정된 적절한 권한이 있는 계정 또는 관리 권한이 필요합니다.
매개변수
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되었습니다. |
PECL win32service 0.3.0 | ACL이 다른 계정에 대해 설정된 경우 이 함수는 더 이상 관리자 계정이 필요하지 않습니다. |
기타
- win32_start_service() - 서비스 시작
- win32_pause_service() - 서비스 일시 중지
- win32_continue_service() - 일시 중지된 서비스를 재개합니다.
- win32_send_custom_control() - 서비스에 사용자 지정 컨트롤 보내기
- Win32 오류 코드