Voltar à lista
Windows Win32Serviçosadvapi32.dll

SetServiceStatus

Atualiza o estado reportado de um serviço em execução perante o SCM.

Descrição

O processo do serviço deve chamar periodicamente durante inicializações longas (com checkpoints incrementais) para evitar que o SCM o considere travado e o encerre.

Header: winsvc.hDLL: advapi32.dll

Assinatura

BOOL SetServiceStatus(
    SERVICE_STATUS_HANDLE hServiceStatus,
    LPSERVICE_STATUS lpServiceStatus
);

Parâmetros

ParâmetroTipoDescrição
hServiceStatusSERVICE_STATUS_HANDLEHandle obtido de RegisterServiceCtrlHandlerW.
lpServiceStatusLPSERVICE_STATUSNovo estado a reportar.

Valor de retorno

Diferente de zero em sucesso; 0 em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_INVALID_DATA(13)
Os dados são inválidos.

Relacionadas

Mesma categoria

ChangeServiceConfigWCloseServiceHandleControlServiceCreateServiceWDeleteServiceEnumServicesStatusExWOpenSCManagerWOpenServiceW