structure SERVICE_TRIGGER_SPECIFIC_DATA_ITEM (winsvc.h)

Article
08/27/2023

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.

Valeur	Signification
SERVICE_TRIGGER_DATA_TYPE_BINARY 1	Les données spécifiques au déclencheur sont au format binaire.
SERVICE_TRIGGER_DATA_TYPE_STRING 2	Les données spécifiques au déclencheur sont au format chaîne.
SERVICE_TRIGGER_DATA_TYPE_LEVEL 3	Les données spécifiques au déclencheur sont une valeur d’octet.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ANY 4	Les données spécifiques au déclencheur sont une valeur entière non signée 64 bits.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ALL 5	Les données spécifiques au déclencheur sont une valeur entière non signée 64 bits.

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

Voir aussi

ChangeServiceConfig2

QueryServiceConfig2

SERVICE_TRIGGER

Événements du déclencheur de service

Partager via