Condividi tramite


struttura SERVICE_TRIGGER_SPECIFIC_DATA_ITEM (winsvc.h)

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.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Intestazione winsvc.h

Vedi anche

ChangeServiceConfig2

QueryServiceConfig2

SERVICE_TRIGGER

Eventi trigger di servizio