Compartir a través de

estructura SERVICE_TRIGGER_SPECIFIC_DATA_ITEM (winsvc.h)

  • Artículo

Contiene datos específicos del desencadenador para un evento de desencadenador de servicio. Esta estructura la usa la estructura de SERVICE_TRIGGER para los eventos de desencadenador de SERVICE_TRIGGER_TYPE_CUSTOM, SERVICE_TRIGGER_TYPE_DEVICE_ARRIVAL, SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT o SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT.

Sintaxis

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

Miembros

dwDataType

Tipo de datos de los datos específicos del desencadenador a los que apunta pData. Este miembro puede ser uno de los valores siguientes.

Valor Significado
SERVICE_TRIGGER_DATA_TYPE_BINARY
1
 Los datos específicos del desencadenador están en formato binario.
SERVICE_TRIGGER_DATA_TYPE_STRING
2
 Los datos específicos del desencadenador están en formato de cadena.
SERVICE_TRIGGER_DATA_TYPE_LEVEL
3
 Los datos específicos del desencadenador son un valor de byte.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ANY
4
 Los datos específicos del desencadenador son un valor entero de 64 bits sin signo.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ALL
5
 Los datos específicos del desencadenador son un valor entero de 64 bits sin signo.

cbData

Tamaño de los datos específicos del desencadenador apuntados a pData, en bytes. El valor máximo es 1024.

pData

Puntero a los datos específicos del desencadenador para el evento de desencadenador de servicio. Los datos específicos del desencadenador dependen del tipo de evento del desencadenador; vea Comentarios.

Si el miembro dwDataType es SERVICE_TRIGGER_DATA_TYPE_BINARY, los datos específicos del desencadenador son una matriz de bytes.

Si el miembro dwDataType es SERVICE_TRIGGER_DATA_TYPE_STRING, los datos específicos del desencadenador son una cadena terminada en null o una cadena multicadena de cadenas terminadas en NULL, que termina con dos caracteres de terminación NULL. Por ejemplo: "5001\0UDP\0%programfiles%\MyApplication\MyServiceProcess.exe\0MyService\0\0".

Las cadenas deben ser Unicode; No se admiten cadenas ANSI.

Comentarios

En la tabla siguiente se enumeran los datos específicos del desencadenador por tipo de evento de desencadenador.

Tipo de evento Datos específicos del desencadenador
SERVICE_TRIGGER_TYPE_CUSTOM Especificado por el proveedor seguimiento de eventos para Windows (ETW) que define el evento personalizado.
SERVICE_TRIGGER_TYPE_DEVICE_INTERFACE_ARRIVAL Cadena SERVICE_TRIGGER_DATA_TYPE_STRING que especifica un identificador de hardware o una cadena de identificador compatible para la clase de interfaz de dispositivo.
SERVICE_TRIGGER_TYPE_DOMAIN_JOIN No es aplicable.
SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT Un SERVICE_TRIGGER_DATA_TYPE_STRING cadena múltiple que especifica el puerto, el protocolo y, opcionalmente, la ruta de acceso ejecutable y el nombre del servicio que escucha en el evento.
SERVICE_TRIGGER_TYPE_GROUP_POLICY No es aplicable.
SERVICE_TRIGGER_TYPE_IP_ADDRESS_AVAILABILITY No es aplicable.
SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT Un SERVICE_TRIGGER_DATA_TYPE_STRING que especifica el puerto, la canalización con nombre o la interfaz RPC para el punto de conexión de red.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado winsvc.h

Consulte también

ChangeServiceConfig2

QueryServiceConfig2

SERVICE_TRIGGER

Eventos de desencadenador de servicio