SERVICE_TRIGGER_SPECIFIC_DATA_ITEM-Struktur (winsvc.h)
Enthält triggerspezifische Daten für ein Diensttriggerereignis. Diese Struktur wird von der SERVICE_TRIGGER-Struktur für SERVICE_TRIGGER_TYPE_CUSTOM-, SERVICE_TRIGGER_TYPE_DEVICE_ARRIVAL-, SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT- oder SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT Triggerereignisse verwendet.
Syntax
typedef struct _SERVICE_TRIGGER_SPECIFIC_DATA_ITEM {
DWORD dwDataType;
DWORD cbData;
PBYTE pData;
} SERVICE_TRIGGER_SPECIFIC_DATA_ITEM, *PSERVICE_TRIGGER_SPECIFIC_DATA_ITEM;
Member
dwDataType
Der Datentyp der triggerspezifischen Daten, auf die von pData verwiesen wird. Dieser Member kann einer der folgenden Werte sein.
cbData
Die Größe der triggerspezifischen Daten, die auf pData in Bytes verweisen. Der Maximalwert ist 1024.
pData
Ein Zeiger auf die triggerspezifischen Daten für das Diensttriggerereignis. Die triggerspezifischen Daten hängen vom Triggerereignistyp ab. siehe Hinweise.
Wenn das dwDataType-Element SERVICE_TRIGGER_DATA_TYPE_BINARY ist, sind die triggerspezifischen Daten ein Array von Bytes.
Wenn das dwDataType-Element SERVICE_TRIGGER_DATA_TYPE_STRING ist, sind die triggerspezifischen Daten eine NULL-beendete Zeichenfolge oder eine Multizeichenfolge von null-beendeten Zeichenfolgen, die mit zwei NULL-Endzeichen enden. Beispiel: "5001\0UDP\0%programfiles%\MyApplication\MyServiceProcess.exe\0MyService\0\0".
Zeichenfolgen müssen Unicode sein. ANSI-Zeichenfolgen werden nicht unterstützt.
Hinweise
In der folgenden Tabelle sind triggerspezifische Daten nach Triggerereignistyp aufgeführt.
| Ereignistyp | Triggerspezifische Daten |
|---|---|
| SERVICE_TRIGGER_TYPE_CUSTOM | Wird vom ETW-Anbieter ( Event Tracing for Windows ) angegeben, der das benutzerdefinierte Ereignis definiert. |
| SERVICE_TRIGGER_TYPE_DEVICE_INTERFACE_ARRIVAL | Eine SERVICE_TRIGGER_DATA_TYPE_STRING Zeichenfolge, die eine Hardware-ID oder eine kompatible ID-Zeichenfolge für die Geräteschnittstellenklasse angibt. |
| SERVICE_TRIGGER_TYPE_DOMAIN_JOIN | Nicht zutreffend. |
| SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT | Eine SERVICE_TRIGGER_DATA_TYPE_STRING mehrere Zeichenfolgen, die den Port, das Protokoll und optional den ausführbaren Pfad und den Namen des Diensts angibt, der auf das Ereignis lauscht. |
| SERVICE_TRIGGER_TYPE_GROUP_POLICY | Nicht zutreffend. |
| SERVICE_TRIGGER_TYPE_IP_ADDRESS_AVAILABILITY | Nicht zutreffend. |
| SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT | Eine SERVICE_TRIGGER_DATA_TYPE_STRING, die den Port, die Named Pipe oder die RPC-Schnittstelle für den Netzwerkendpunkt angibt. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Kopfzeile | winsvc.h |