structure SERVICE_TRIGGER_SPECIFIC_DATA_ITEM (winsvc.h)
Contient des données spécifiques au déclencheur pour un événement de déclencheur de service. Cette structure est utilisée par la structure SERVICE_TRIGGER pour les événements déclencheurs SERVICE_TRIGGER_TYPE_CUSTOM, SERVICE_TRIGGER_TYPE_DEVICE_ARRIVAL, SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT ou SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT.
Syntaxe
typedef struct _SERVICE_TRIGGER_SPECIFIC_DATA_ITEM {
DWORD dwDataType;
DWORD cbData;
PBYTE pData;
} SERVICE_TRIGGER_SPECIFIC_DATA_ITEM, *PSERVICE_TRIGGER_SPECIFIC_DATA_ITEM;
Membres
dwDataType
Type de données des données spécifiques au déclencheur pointées par pData. Ce membre peut être l’une des valeurs suivantes.
cbData
Taille des données spécifiques au déclencheur pointées vers pData, en octets. La valeur maximale est 1024.
pData
Pointeur vers les données spécifiques au déclencheur pour l’événement de déclencheur de service. Les données spécifiques au déclencheur dépendent du type d’événement du déclencheur ; voir Remarques.
Si le membre dwDataType est SERVICE_TRIGGER_DATA_TYPE_BINARY, les données spécifiques au déclencheur sont un tableau d’octets.
Si le membre dwDataType est SERVICE_TRIGGER_DATA_TYPE_STRING, les données spécifiques au déclencheur sont une chaîne terminée par null ou une chaîne multistring de chaînes terminées par null, se terminant par deux caractères null. Par exemple : "5001\0UDP\0%programfiles%\MyApplication\MyServiceProcess.exe\0MyService\0\0".
Les chaînes doivent être Unicode ; Les chaînes ANSI ne sont pas prises en charge.
Remarques
Le tableau suivant répertorie les données spécifiques au déclencheur par type d’événement de déclencheur.
| Type d'événement | Données spécifiques au déclencheur |
|---|---|
| SERVICE_TRIGGER_TYPE_CUSTOM | Spécifié par le fournisseur De suivi d’événements pour Windows (ETW) qui définit l’événement personnalisé. |
| SERVICE_TRIGGER_TYPE_DEVICE_INTERFACE_ARRIVAL | Chaîne SERVICE_TRIGGER_DATA_TYPE_STRING qui spécifie un ID matériel ou une chaîne d’ID compatible pour la classe d’interface de l’appareil. |
| SERVICE_TRIGGER_TYPE_DOMAIN_JOIN | Non applicable. |
| SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT | Une SERVICE_TRIGGER_DATA_TYPE_STRING plusieurs chaînes qui spécifient le port, le protocole et éventuellement le chemin d’accès exécutable et le nom du service à l’écoute sur l’événement. |
| SERVICE_TRIGGER_TYPE_GROUP_POLICY | Non applicable. |
| SERVICE_TRIGGER_TYPE_IP_ADDRESS_AVAILABILITY | Non applicable. |
| SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT | Une SERVICE_TRIGGER_DATA_TYPE_STRING qui spécifie le port, le canal nommé ou l’interface RPC pour le point de terminaison réseau. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| En-tête | winsvc.h |