IOCTL_SERVICE_STATUS
A version of this page is also available for
4/8/2010
This IOCTL returns the current running state of the service.
Parameters
pBufOut
[out] Pointer to a DWORD specifying the running state of the service.The following table shows possible values for this parameter.
Value Description SERVICE_STATE_OFF = 0
The service is turned off.
SERVICE_STATE_ON = 1
The service is turned on.
SERVICE_STATE_STARTING_UP = 2
The service is in the process of starting up.
SERVICE_STATE_SHUTTING_DOWN = 3
The service is in the process of shutting down.
SERVICE_STATE_UNLOADING = 4
The service is in the process of unloading.
SERVICE_STATE_UNINITIALIZED = 5
The service is not uninitialized.
SERVICE_STATE_UNKNOWN = 0xffffffff
The state of the service is unknown.
Return Values
Returns TRUE if successful, FALSE otherwise. To obtain extended error information, call the SetLastError function.
Remarks
The running state is returned in the pOutBuf parameter of the xxx_IOControl (Services.exe) function.
Requirements
| Header | service.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |