Voltar à lista
Windows Win32Serviçosadvapi32.dll

RegisterServiceCtrlHandlerW

Registra a função de callback que um serviço usa para receber códigos de controle do SCM.

Descrição

Chamada pelo próprio processo do serviço, logo após iniciar, para poder reagir a comandos como 'pare' enviados via ControlService.

Header: winsvc.hDLL: advapi32.dll

Assinatura

SERVICE_STATUS_HANDLE RegisterServiceCtrlHandlerW(
    LPCWSTR lpServiceName,
    LPHANDLER_FUNCTION lpHandlerProc
);

Parâmetros

ParâmetroTipoDescrição
lpServiceNameLPCWSTRNome do serviço que está se registrando.
lpHandlerProcLPHANDLER_FUNCTIONFunção de callback a receber os códigos de controle.

Valor de retorno

Um handle de status de serviço em sucesso; NULL(0) em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_SERVICE_NOT_IN_EXE(1083)
O executável do serviço não contém o serviço especificado.

Relacionadas