struttura SERVICE_TRIGGER_SPECIFIC_DATA_ITEM (winsvc.h)

Articolo
03/04/2024

Contiene dati specifici del trigger per un evento trigger del servizio. Questa struttura viene utilizzata dalla struttura di SERVICE_TRIGGER per eventi trigger di SERVICE_TRIGGER_TYPE_CUSTOM, SERVICE_TRIGGER_TYPE_DEVICE_ARRIVAL, SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT o SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT.

Sintassi

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

Tipo di dati dei dati specifici del trigger a cui punta pData. Questo membro può essere uno dei valori seguenti.

Valore	Significato
SERVICE_TRIGGER_DATA_TYPE_BINARY 1	I dati specifici del trigger sono in formato binario.
SERVICE_TRIGGER_DATA_TYPE_STRING 2	I dati specifici del trigger sono in formato stringa.
SERVICE_TRIGGER_DATA_TYPE_LEVEL 3	I dati specifici del trigger sono un valore di byte.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ANY 4	I dati specifici del trigger sono un valore intero senza segno a 64 bit.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ALL 5	I dati specifici del trigger sono un valore intero senza segno a 64 bit.

cbData

Dimensioni dei dati specifici del trigger a cui punta pData, in byte. Il valore massimo è 1024.

pData

Puntatore ai dati specifici del trigger per l'evento trigger del servizio. I dati specifici del trigger dipendono dal tipo di evento trigger; vedere Osservazioni.

Se il membro dwDataType è SERVICE_TRIGGER_DATA_TYPE_BINARY, i dati specifici del trigger sono una matrice di byte.

Se il membro dwDataType è SERVICE_TRIGGER_DATA_TYPE_STRING, i dati specifici del trigger sono una stringa con terminazione Null o una multistringa di stringhe con terminazione Null, terminando con due caratteri di terminazione Null. Ad esempio: "5001\0UDP\0%programfiles%\MyApplication\MyServiceProcess.exe\0MyService\0\0".

Le stringhe devono essere Unicode; Le stringhe ANSI non sono supportate.

Commenti

Nella tabella seguente sono elencati i dati specifici del trigger in base al tipo di evento trigger.

Tipo di evento	Dati specifici del trigger
SERVICE_TRIGGER_TYPE_CUSTOM	Specificato dal provider ETW (Event Tracing for Windows ) che definisce l'evento personalizzato.
SERVICE_TRIGGER_TYPE_DEVICE_INTERFACE_ARRIVAL	Stringa SERVICE_TRIGGER_DATA_TYPE_STRING che specifica un ID hardware o una stringa ID compatibile per la classe dell'interfaccia del dispositivo.
SERVICE_TRIGGER_TYPE_DOMAIN_JOIN	Non applicabile.
SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT	Oggetto SERVICE_TRIGGER_DATA_TYPE_STRING stringa multipla che specifica la porta, il protocollo e, facoltativamente, il percorso eseguibile e il nome del servizio in ascolto sull'evento.
SERVICE_TRIGGER_TYPE_GROUP_POLICY	Non applicabile.
SERVICE_TRIGGER_TYPE_IP_ADDRESS_AVAILABILITY	Non applicabile.
SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT	Oggetto SERVICE_TRIGGER_DATA_TYPE_STRING che specifica la porta, la named pipe o l'interfaccia RPC per l'endpoint di rete.