SERVICE_TRIGGER_SPECIFIC_DATA_ITEM構造体 (winsvc.h)
サービス トリガー イベントのトリガー固有のデータが含まれます。 この構造体は、SERVICE_TRIGGER_TYPE_CUSTOM、 SERVICE_TRIGGER_TYPE_DEVICE_ARRIVAL 、SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT、またはトリガー イベントのSERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT SERVICE_TRIGGER構造体によって使用されます。
構文
typedef struct _SERVICE_TRIGGER_SPECIFIC_DATA_ITEM {
DWORD dwDataType;
DWORD cbData;
PBYTE pData;
} SERVICE_TRIGGER_SPECIFIC_DATA_ITEM, *PSERVICE_TRIGGER_SPECIFIC_DATA_ITEM;
メンバー
dwDataType
pData が指すトリガー固有のデータのデータ型。 このメンバーには、次のいずれかの値を指定できます。
cbData
pData を指すトリガー固有のデータのサイズ (バイト単位)。 最大値は 1024 です。
pData
サービス トリガー イベントのトリガー固有データへのポインター。 トリガー固有のデータは、トリガー イベントの種類によって異なります。「解説」を参照してください。
dwDataType メンバーがSERVICE_TRIGGER_DATA_TYPE_BINARY場合、トリガー固有のデータはバイト配列です。
dwDataType メンバーがSERVICE_TRIGGER_DATA_TYPE_STRING場合、トリガー固有のデータは null で終わる文字列または null で終わる文字列の複数文字列で、2 つの null 終端文字で終わる。 (例: "5001\0UDP\0%programfiles%\MyApplication\MyServiceProcess.exe\0MyService\0\0")。
文字列は Unicode である必要があります。ANSI 文字列はサポートされていません。
注釈
次の表に、トリガー固有のデータをトリガー イベントの種類別に示します。
| イベントの種類 | トリガー固有のデータ |
|---|---|
| SERVICE_TRIGGER_TYPE_CUSTOM | カスタム イベントを定義する Event Tracing for Windows (ETW) プロバイダーによって指定されます。 |
| SERVICE_TRIGGER_TYPE_DEVICE_INTERFACE_ARRIVAL | デバイス インターフェイス クラスのハードウェア ID または互換性のある ID 文字列を指定するSERVICE_TRIGGER_DATA_TYPE_STRING文字列。 |
| SERVICE_TRIGGER_TYPE_DOMAIN_JOIN | 適用不可。 |
| SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT | ポート、プロトコル、および必要に応じてイベントをリッスンするサービスの実行可能パスと名前を指定するSERVICE_TRIGGER_DATA_TYPE_STRINGマルチ文字列。 |
| SERVICE_TRIGGER_TYPE_GROUP_POLICY | 適用不可。 |
| SERVICE_TRIGGER_TYPE_IP_ADDRESS_AVAILABILITY | 適用不可。 |
| SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT | ネットワーク エンドポイントのポート、名前付きパイプ、または RPC インターフェイスを指定するSERVICE_TRIGGER_DATA_TYPE_STRING。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| Header | winsvc.h |