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 が指すトリガー固有のデータのデータ型。 このメンバーには、次のいずれかの値を指定できます。

値 意味
SERVICE_TRIGGER_DATA_TYPE_BINARY
1
 トリガー固有のデータはバイナリ形式です。
SERVICE_TRIGGER_DATA_TYPE_STRING
2
 トリガー固有のデータは文字列形式です。
SERVICE_TRIGGER_DATA_TYPE_LEVEL
3
 トリガー固有のデータはバイト値です。
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ANY
4
 トリガー固有のデータは、64 ビット符号なし整数値です。
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ALL
5
 トリガー固有のデータは、64 ビット符号なし整数値です。

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

こちらもご覧ください

ChangeServiceConfig2

QueryServiceConfig2

SERVICE_TRIGGER

サービス トリガー イベント