2.2.43 SERVICE_NOTIFY_STATUS_CHANGE_PARAMS_1

  • Article

The SERVICE_NOTIFY_STATUS_CHANGE_PARAMS_1 structure defines the service status notification information. If a client uses this structure, the server copies data from this structure to the newer structure specified in 2.2.44, and uses the newer structure.

 typedef struct _SERVICE_NOTIFY_STATUS_CHANGE_PARAMS_1 {
   ULONGLONG ullThreadId;
   DWORD dwNotifyMask;
   UCHAR CallbackAddressArray[16];
   UCHAR CallbackParamAddressArray[16];
   SERVICE_STATUS_PROCESS ServiceStatus;
   DWORD dwNotificationStatus;
   DWORD dwSequence;
 } SERVICE_NOTIFY_STATUS_CHANGE_PARAMS_1,
  *PSERVICE_NOTIFY_STATUS_CHANGE_PARAMS_1;

ullThreadId: Not used.

dwNotifyMask: A value that specifies the status changes in which the client is interested. It MUST be one or more of the following values.

Value

Meaning

SERVICE_NOTIFY_CREATED

0x00000080

Report when the service has been created.

SERVICE_NOTIFY_CONTINUE_PENDING

0x00000010

Report when the service is about to continue.

SERVICE_NOTIFY_DELETE_PENDING

0x00000200

Report when an application has specified the service to delete.

SERVICE_NOTIFY_DELETED

0x00000100

Report when the service has been deleted.

SERVICE_NOTIFY_PAUSE_PENDING

0x00000020

Report when the service is pausing.

SERVICE_NOTIFY_PAUSED

0x00000040

Report when the service has paused.

SERVICE_NOTIFY_RUNNING

0x00000008

Report when the service is running.

SERVICE_NOTIFY_START_PENDING

0x00000002

Report when the service is starting.

SERVICE_NOTIFY_STOP_PENDING

0x00000004

Report when the service is stopping.

SERVICE_NOTIFY_STOPPED

0x00000001

Report when the service has stopped.

CallbackAddressArray: Not used.

CallbackParamAddressArray: Not used.

ServiceStatus: A SERVICE_STATUS_PROCESS (section 2.2.49) structure that contains information about the service.

dwNotificationStatus: A value that indicates the notification status. If this member is ERROR_SUCCESS, the notification has succeeded and the server adds valid information to the ServiceStatus, dwNotificationTriggered, and pszServiceNames members. If this member is ERROR_REQUEST_ABORTED or ERROR_SERVICE_MARKED_FOR_DELETE, the notification has failed.

dwSequence: Not used.