Voltar à lista
Windows Win32Serviçosadvapi32.dll

StartServiceCtrlDispatcherW

Conecta a thread principal do processo ao Service Control Manager, entregando o controle a ele até que todos os serviços parem.

Descrição

Chamada obrigatória e bloqueante no ponto de entrada de qualquer executável que hospeda um ou mais serviços Win32 — análogo, em espírito, a como um processo daemon Linux se registra e entra em seu loop principal sob supervisão do systemd (embora o mecanismo seja completamente diferente).

Header: winsvc.hDLL: advapi32.dll

Assinatura

BOOL StartServiceCtrlDispatcherW(
    const SERVICE_TABLE_ENTRYW * lpServiceStartTable
);

Parâmetros

ParâmetroTipoDescrição
lpServiceStartTableconst SERVICE_TABLE_ENTRYW *Tabela de nomes de serviço e suas funções de entrada, terminada por uma entrada NULL.

Valor de retorno

Diferente de zero quando todos os serviços do processo pararam; 0 em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_FAILED_SERVICE_CONTROLLER_CONNECT(1063)
O processo não pôde se conectar ao Service Controller.
ERROR_SERVICE_ALREADY_RUNNING(1056)
Uma instância do serviço já está em execução.

Relacionadas

Mesma categoria

ChangeServiceConfigWCloseServiceHandleControlServiceCreateServiceWDeleteServiceEnumServicesStatusExWOpenSCManagerWOpenServiceW