IOCTL_SERVICE_STATUS

  • Article

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 function.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Service.h.

See Also

xxx_IOControl

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.