FServiceReportStatus

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

Quick Info

Header file: WINWRAP.H
Library: WINWRAP.LIB 

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