LPSERVICE_MAIN_FUNCTIONA 콜백 함수(winsvc.h)
서비스의 진입점입니다.
LPSERVICE_MAIN_FUNCTION 형식은 이 콜백 함수에 대한 포인터를 정의합니다. ServiceMain 애플리케이션 정의 함수 이름의 자리 표시자입니다.
통사론
LPSERVICE_MAIN_FUNCTIONA LpserviceMainFunctiona;
void LpserviceMainFunctiona(
[in] DWORD dwNumServicesArgs,
[in] LPSTR *lpServiceArgVectors
)
{...}
매개 변수
[in] dwNumServicesArgs
lpServiceArgVectors 배열의 인수 수입니다.
[in] lpServiceArgVectors
서비스를 시작한 StartService 함수를 호출하여 서비스에 전달된 null로 끝나는 인수 문자열입니다. 인수가 없으면 이 매개 변수는 NULL일 수 있습니다. 그렇지 않으면 첫 번째 인수(lpServiceArgVectors[0])는 서비스의 이름이며, 그 다음에는 추가 인수(lpServiceArgVectors[1]~lpServiceArgVectors[dwNumServicesArgs-1])가 옵니다.
사용자가 제어판에서 서비스 스냅인을 사용하여 수동 서비스를 시작하는 경우 lpServiceArgVectors 매개 변수에 대한 문자열은 서비스에 대한 속성 대화 상자에서 가져옵니다(서비스 스냅인에서 서비스 항목을 마우스 오른쪽 단추로 클릭하고 속성클릭하고 시작 매개 변수에 매개 변수를 입력합니다.
반환 값
없음
발언
서비스 프로그램은 하나 이상의 서비스를 시작할 수 있습니다. 서비스 프로세스에는 시작할 수 있는 각 서비스에 대한 SERVICE_TABLE_ENTRY 구조가 있습니다. 구조체는 서비스 이름과 해당 서비스에 대한 ServiceMain 함수에 대한 포인터를 지정합니다.
서비스 제어 관리자가 서비스 시작 요청을 받으면 서비스 프로세스가 시작됩니다(아직 실행되고 있지 않은 경우). 서비스 프로세스의 주 스레드는 SERVICE_TABLE_ENTRY 구조의 배열에 대한 포인터를 사용하여 StartServiceCtrlDispatcher 함수를 호출합니다. 그런 다음 서비스 제어 관리자는 이 서비스 프로세스에 대한 서비스 제어 디스패처에 시작 요청을 보냅니다. 서비스 제어 디스패처는 새 스레드를 만들어 시작 중인 서비스의 ServiceMain 함수를 실행합니다.
ServiceMain 함수는 RegisterServiceCtrlHandlerEx 함수를 즉시 호출하여 제어 요청을 처리하는 HandlerEx 함수를 지정해야 합니다. 다음으로, SetServiceStatus 함수를 호출하여 상태 정보를 서비스 제어 관리자로 보내야 합니다. 이러한 호출 후에는 함수가 서비스 초기화를 완료해야 합니다. ServiceMain 함수에서 다른 서비스를 시작하지 마세요.
SCM(서비스 제어 관리자)은 서비스가 SERVICE_RUNNING 상태를 보고할 때까지 기다립니다. SCM과의 상호 작용이 필요한 시스템의 다른 구성 요소가 이 시간 동안 차단되므로 서비스가 가능한 한 빨리 이 상태를 보고하는 것이 좋습니다. 일부 함수에는 직접 또는 간접적으로 SCM과의 상호 작용이 필요할 수 있습니다.
SCM은 초기화 중에 서비스 제어 데이터베이스를 잠그므로 초기화 중에 서비스가 StartService 호출하려고 하면 호출이 차단됩니다. 서비스가 SCM에 성공적으로 시작되었다고 보고하면 StartService호출할 수 있습니다. 서비스에서 다른 서비스를 실행해야 하는 경우 서비스는 필요한 종속성을 설정해야 합니다.
또한 서비스 초기화 중에 시스템 함수를 호출해서는 안 됩니다. 서비스 코드는 SERVICE_RUNNING 상태를 보고한 후에만 시스템 함수를 호출해야 합니다.
ServiceMain 함수는 전역 이벤트를 만들고, 이 이벤트에서 RegisterWaitForSingleObject 함수를 호출하고, 종료해야 합니다. 그러면 ServiceMain 함수를 실행하는 스레드가 종료되지만 서비스가 종료되지는 않습니다. 서비스가 중지되면 서비스 제어 처리기는 SERVICE_STOP_PENDING 사용하여 SetServiceStatus 호출하고 이 이벤트에 신호를 보내야 합니다. 스레드 풀의 스레드는 대기 콜백 함수를 실행합니다. 이 함수는 전역 이벤트 닫기를 포함하여 정리 작업을 수행하고 SERVICE_STOPPED SetServiceStatus 호출해야 합니다. 서비스가 중지된 후에는 서비스가 시작 컨트롤을 수신하고 ServiceMain 다시 호출될
예제
예를 들어 serviceMain 함수
메모
winsvc.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 LPSERVICE_MAIN_FUNCTION 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winsvc.h(Windows.h 포함) |
참고 항목
registerServiceCtrlHandlerEx
RegisterWaitForSingleObject
SetServiceStatus