FServiceReportStatus

The FServiceReportStatus function updates the status of a service of Windows NT Server to the Windows NT service control manager.

Quick Info

BOOL FServiceReportStatus(
  DWORD dwCurrentState,             
  DWORD dwWin32ExitCode,            
  DWORD dwServiceSpecificExitCode,  
  DWORD dwCheckPoint,               
  DWORD dwWaitHint                  
);
 

Parameters

dwCurrentState

Input parameter. Indicates the current state of the service of Windows NT Server. Value can be one of the following:

SERVICE_CONTINUE_PENDING

SERVICE_PAUSE_PENDING

SERVICE_PAUSED

SERVICE_RUNNING

SERVICE_START_PENDING

SERVICE_STOP_PENDING

SERVICE_STOPPED

dwWin32ExitCode

Input parameter. Specifies a Win32 error code used by the service of Windows NT Server to report a starting or stopping error.

dwServiceSpecificExitCode

Input parameter. Specifies the service-specific exit code.

dwCheckPoint

Input parameter. Specifies the value that the service of Windows NT Server increments periodically to report its progress during a lengthy start, stop, or continue operation.

dwWaitHint

Input parameter. Specifies the time period (in milliseconds) that the service of Windows NT Server expects a pending start, stop, or continue operation to take.

Return Values

See Return Values.

Remarks

FServiceReportStatus is called by the ServiceMain function to update the service's status to the service control manager.

For more information on the WINWRAP library, see Using WINWRAP Functions, Mandatory Entry Points and Variables, and Events Signalled.

See Also

fIsService, HrServiceConfirmStop, HrServiceGetArgv, HrServiceGetName, HrServiceProcessControl, HrServiceShutdown, HrServiceStartup, HrServiceWaitForContinue, HrServiceWaitForControl, HrServiceWaitForStop, HServiceCreateThread, ServiceStop