Writing a Service Program's main Function

最新推荐文章于 2024-03-11 00:56:41 发布

原创最新推荐文章于 2024-03-11 00:56:41 发布 · 1.1k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#service #function #thread #string #buffer #winapi

博客介绍了服务程序主函数的编写，主函数调用StartServiceCtrlDispatcher连接SCM并启动控制调度线程，该线程循环等待控制请求，直至出错或所有服务终止。还给出支持单服务的示例，若支持多服务，主函数实现略有不同，需在调度表添加服务名。

Writing a Service Program's main Function

The main function of a service program calls the StartServiceCtrlDispatcher function to connect to the SCM and start the control dispatcher thread. The dispatcher thread loops, waiting for incoming control requests for the services specified in the dispatch table. This thread does not return until there is an error or all of the services in the process have terminated. When all services in a process have terminated, the SCM sends a control request to the dispatcher thread telling it to shut down. The thread can then return from the StartServiceCtrlDispatcher call and the process can terminate.

The following example is a service process that supports only one service. The SvcDebugOut function prints informational messages and errors to the debugger. It takes two parameters: a string that can contain one formatted output character and a numeric value to be used as the formatted character. For information on writing the MyServiceStart and MyServiceInitialization functions, see Writing a ServiceMain Function. For information on writing the MyServiceCtrlHandler function, see Writing a Control Handler Function.

#include <windows.h>

SERVICE_STATUS          MyServiceStatus; 
SERVICE_STATUS_HANDLE   MyServiceStatusHandle; 

VOID SvcDebugOut(LPSTR String, DWORD Status);
VOID  WINAPI MyServiceCtrlHandler (DWORD opcode); 
VOID  MyServiceStart (DWORD argc, LPTSTR *argv); 
DWORD MyServiceInitialization (DWORD argc, LPTSTR *argv, 
        DWORD *specificError); 
 
void main( ) 
{ 
   SERVICE_TABLE_ENTRY   DispatchTable[] = 
   { 
      { "MyService", MyServiceStart      }, 
      { NULL,              NULL          } 
   }; 
 
   if (!StartServiceCtrlDispatcher( DispatchTable)) 
   { 
      SvcDebugOut(" [MY_SERVICE] StartServiceCtrlDispatcher (%d)/n", 
         GetLastError()); 
   } 
} 
 
VOID SvcDebugOut(LPSTR String, DWORD Status) 
{ 
   CHAR  Buffer[1024]; 
   if (strlen(String) < 1000) 
   { 
      sprintf(Buffer, String, Status); 
      OutputDebugStringA(Buffer); 
   } 
}

If your service program supports multiple services, the implementation of the main function will differ slightly. The names of the additional services should be added to the dispatch table so they can be monitored by the dispatcher thread.