SERVICE_TRIGGER_SPECIFIC_DATA_ITEM-Struktur (winsvc.h)

  • Artikel

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.

Wert Bedeutung
SERVICE_TRIGGER_DATA_TYPE_BINARY
1
 Die triggerspezifischen Daten sind im Binärformat.
SERVICE_TRIGGER_DATA_TYPE_STRING
2
 Die triggerspezifischen Daten sind im Zeichenfolgenformat.
SERVICE_TRIGGER_DATA_TYPE_LEVEL
3
 Die triggerspezifischen Daten sind ein Bytewert.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ANY
4
 Die triggerspezifischen Daten sind ein 64-Bit-Ganzzahlwert ohne Vorzeichen.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ALL
5
 Die triggerspezifischen Daten sind ein 64-Bit-Ganzzahlwert ohne Vorzeichen.

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

Weitere Informationen

ChangeServiceConfig2

QueryServiceConfig2

SERVICE_TRIGGER

Diensttriggerereignisse