SERVICE_TRIGGER_SPECIFIC_DATA_ITEM structure (winsvc.h)

Contains trigger-specific data for a service trigger event. This structure is used by the SERVICE_TRIGGER structure for SERVICE_TRIGGER_TYPE_CUSTOM, SERVICE_TRIGGER_TYPE_DEVICE_ARRIVAL, SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT, or SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT trigger events.

Syntax

typedef struct _SERVICE_TRIGGER_SPECIFIC_DATA_ITEM {
  DWORD dwDataType;
  DWORD cbData;
  PBYTE pData;
} SERVICE_TRIGGER_SPECIFIC_DATA_ITEM, *PSERVICE_TRIGGER_SPECIFIC_DATA_ITEM;

Members

dwDataType

The data type of the trigger-specific data pointed to by pData. This member can be one of the following values.

cbData

The size of the trigger-specific data pointed to pData, in bytes. The maximum value is 1024.

pData

A pointer to the trigger-specific data for the service trigger event. The trigger-specific data depends on the trigger event type; see Remarks.

If the dwDataType member is SERVICE_TRIGGER_DATA_TYPE_BINARY, the trigger-specific data is an array of bytes.

If the dwDataType member is SERVICE_TRIGGER_DATA_TYPE_STRING, the trigger-specific data is a null-terminated string or a multistring of null-terminated strings, ending with two null-terminating characters. For example: "5001\0UDP\0%programfiles%\MyApplication\MyServiceProcess.exe\0MyService\0\0".

Strings must be Unicode; ANSI strings are not supported.

Remarks

The following table lists trigger-specific data by trigger event type.

Requirements

See also

ChangeServiceConfig2

QueryServiceConfig2

SERVICE_TRIGGER

Service Trigger Events