Função StartServiceCtrlDispatcherA (winsvc.h)
Conecta o thread principal de um processo de serviço ao gerenciador de controle de serviço, o que faz com que o thread seja o thread do dispatcher de controle de serviço para o processo de chamada.
Sintaxe
BOOL StartServiceCtrlDispatcherA(
[in] const SERVICE_TABLE_ENTRYA *lpServiceStartTable
);
Parâmetros
[in] lpServiceStartTable
Um ponteiro para uma matriz de estruturas de SERVICE_TABLE_ENTRY que contém uma entrada para cada serviço que pode ser executada no processo de chamada. Os membros da última entrada na tabela devem ter valores NULL para designar o final da tabela.
Valor de retorno
Se a função for bem-sucedida, o valor retornado não será zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
O código de erro a seguir pode ser definido pelo gerenciador de controle de serviço. Outros códigos de erro podem ser definidos pelas funções do Registro que são chamadas pelo gerenciador de controle de serviço.
| Código de retorno | Descrição |
|---|---|
|
Esse erro será retornado se o programa estiver sendo executado como um aplicativo de console e não como um serviço.
Se o programa for executado como um aplicativo de console para fins de depuração, estruture-o de modo que o código específico do serviço não seja chamado quando esse erro for retornado. |
|
A tabela de expedição especificada contém entradas que não estão no formato adequado. |
|
O processo já chamou StartServiceCtrlDispatcher. Cada processo pode chamar StartServiceCtrlDispatcher apenas uma vez. |
Observações
Quando o gerenciador de controle de serviço inicia um processo de serviço, ele aguarda que o processo chame a função
O parâmetro lpServiceTable contém uma entrada para cada serviço que pode ser executado no processo de chamada. Cada entrada especifica a função
Se um serviço for executado em seu próprio processo, o thread principal do processo de serviço deverá chamar imediatamente StartServiceCtrlDispatcher. Todas as tarefas de inicialização são feitas na função ServiceMain do serviço quando o serviço é iniciado.
Se vários serviços compartilharem um processo e alguma inicialização comum em todo o processo precisar ser feita antes que qualquer função ServiceMain seja chamada, o thread principal poderá fazer o trabalho antes de chamar StartServiceCtrlDispatcher, desde que leve menos de 30 segundos. Caso contrário, outro thread deve ser criado para fazer a inicialização em todo o processo, enquanto o thread principal chama StartServiceCtrlDispatcher e se torna o dispatcher de controle de serviço. Qualquer inicialização específica do serviço ainda deve ser feita nas funções principais de serviço individuais.
Os serviços não devem tentar exibir uma interface do usuário diretamente. Para obter mais informações, consulte de Serviços Interativos.
Exemplos
Para obter um exemplo, consulte Gravando a função principal de um programa de serviço.
Nota
O cabeçalho winsvc.h define StartServiceCtrlDispatcher como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winsvc.h (incluir Windows.h) |
| biblioteca | Advapi32.lib |
| de DLL |
Advapi32.dll |
Consulte também
do ponto de entrada do serviço