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