struktur SERVICE_TRIGGER_SPECIFIC_DATA_ITEM (winsvc.h)

Artikel
08/27/2023

Berisi data khusus pemicu untuk peristiwa pemicu layanan. Struktur ini digunakan oleh struktur SERVICE_TRIGGER untuk peristiwa pemicu SERVICE_TRIGGER_TYPE_CUSTOM, SERVICE_TRIGGER_TYPE_DEVICE_ARRIVAL, SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT, atau SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT.

Sintaks

typedef struct _SERVICE_TRIGGER_SPECIFIC_DATA_ITEM {
  DWORD dwDataType;
  DWORD cbData;
  PBYTE pData;
} SERVICE_TRIGGER_SPECIFIC_DATA_ITEM, *PSERVICE_TRIGGER_SPECIFIC_DATA_ITEM;

Anggota

dwDataType

Jenis data data khusus pemicu yang diacu oleh pData. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
SERVICE_TRIGGER_DATA_TYPE_BINARY 1	Data khusus pemicu dalam format biner.
SERVICE_TRIGGER_DATA_TYPE_STRING 2	Data khusus pemicu dalam format string.
SERVICE_TRIGGER_DATA_TYPE_LEVEL 3	Data khusus pemicu adalah nilai byte.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ANY 4	Data khusus pemicu adalah nilai bilangan bulat yang tidak ditandatangani 64-bit.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ALL 5	Data khusus pemicu adalah nilai bilangan bulat yang tidak ditandatangani 64-bit.

cbData

Ukuran data khusus pemicu yang menunjuk ke pData, dalam byte. Nilai maksimum adalah 1024.

pData

Penunjuk ke data khusus pemicu untuk peristiwa pemicu layanan. Data khusus pemicu tergantung pada jenis peristiwa pemicu; lihat Keterangan.

Jika anggota dwDataType SERVICE_TRIGGER_DATA_TYPE_BINARY, data khusus pemicu adalah array byte.

Jika anggota dwDataType SERVICE_TRIGGER_DATA_TYPE_STRING, data khusus pemicu adalah string yang dihentikan null atau multistring string null-terminated, diakhiri dengan dua karakter null-terminating. Misalnya: "5001\0UDP\0%programfiles%\MyApplication\MyServiceProcess.exe\0MyService\0\0".

String harus Unicode; String ANSI tidak didukung.

Keterangan

Tabel berikut ini mencantumkan data khusus pemicu berdasarkan jenis peristiwa pemicu.

Jenis peristiwa	Data khusus pemicu
SERVICE_TRIGGER_TYPE_CUSTOM	Ditentukan oleh penyedia Pelacakan Peristiwa untuk Windows (ETW) yang menentukan peristiwa kustom.
SERVICE_TRIGGER_TYPE_DEVICE_INTERFACE_ARRIVAL	String SERVICE_TRIGGER_DATA_TYPE_STRING yang menentukan ID perangkat keras atau string ID yang kompatibel untuk kelas antarmuka perangkat.
SERVICE_TRIGGER_TYPE_DOMAIN_JOIN	Tidak dapat diterapkan.
SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT	SERVICE_TRIGGER_DATA_TYPE_STRING multi-string yang menentukan port, protokol, dan secara opsional jalur yang dapat dieksekusi dan nama layanan yang mendengarkan pada peristiwa tersebut.
SERVICE_TRIGGER_TYPE_GROUP_POLICY	Tidak dapat diterapkan.
SERVICE_TRIGGER_TYPE_IP_ADDRESS_AVAILABILITY	Tidak dapat diterapkan.
SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT	SERVICE_TRIGGER_DATA_TYPE_STRING yang menentukan port, pipa bernama, atau antarmuka RPC untuk titik akhir jaringan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	winsvc.h

Lihat juga

ChangeServiceConfig2

QueryServiceConfig2

SERVICE_TRIGGER

Peristiwa Pemicu Layanan

Bagikan melalui