estrutura SERVICE_TRIGGER_SPECIFIC_DATA_ITEM (winsvc.h)

  • Artigo

Contém dados específicos do gatilho para um evento de gatilho de serviço. Essa estrutura é usada pela estrutura de SERVICE_TRIGGER para eventos de gatilho de SERVICE_TRIGGER_TYPE_CUSTOM, SERVICE_TRIGGER_TYPE_DEVICE_ARRIVAL, SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT ou SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT.

Sintaxe

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

Membros

dwDataType

O tipo de dados dos dados específicos do gatilho apontados pelo pData. Esse membro pode ser um dos valores a seguir.

Valor Significado
SERVICE_TRIGGER_DATA_TYPE_BINARY
1
 Os dados específicos do gatilho estão no formato binário.
SERVICE_TRIGGER_DATA_TYPE_STRING
2
 Os dados específicos do gatilho estão no formato de cadeia de caracteres.
SERVICE_TRIGGER_DATA_TYPE_LEVEL
3
 Os dados específicos do gatilho são um valor de byte.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ANY
4
 Os dados específicos do gatilho são um valor inteiro sem sinal de 64 bits.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ALL
5
 Os dados específicos do gatilho são um valor inteiro sem sinal de 64 bits.

cbData

O tamanho dos dados específicos do gatilho apontados para pData, em bytes. O valor máximo é de 1024.

pData

Um ponteiro para os dados específicos do gatilho para o evento de gatilho de serviço. Os dados específicos do gatilho dependem do tipo de evento de gatilho; consulte Comentários.

Se o membro dwDataType for SERVICE_TRIGGER_DATA_TYPE_BINARY, os dados específicos do gatilho serão uma matriz de bytes.

Se o membro dwDataType for SERVICE_TRIGGER_DATA_TYPE_STRING, os dados específicos do gatilho serão uma cadeia de caracteres terminada em nulo ou uma multistring de cadeias de caracteres terminadas em nulo, terminando com dois caracteres de terminação nula. Por exemplo: "5001\0UDP\0%programfiles%\MyApplication\MyServiceProcess.exe\0MyService\0\0".

As cadeias de caracteres devem ser Unicode; Não há suporte para cadeias de caracteres ANSI.

Comentários

A tabela a seguir lista dados específicos do gatilho por tipo de evento de gatilho.

Tipo de evento Dados específicos do gatilho
SERVICE_TRIGGER_TYPE_CUSTOM Especificado pelo provedor ETW ( Rastreamento de Eventos para Windows ) que define o evento personalizado.
SERVICE_TRIGGER_TYPE_DEVICE_INTERFACE_ARRIVAL Uma cadeia de caracteres SERVICE_TRIGGER_DATA_TYPE_STRING que especifica uma ID de hardware ou uma cadeia de caracteres de ID compatível para a classe de interface do dispositivo.
SERVICE_TRIGGER_TYPE_DOMAIN_JOIN Não aplicável.
SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT Um SERVICE_TRIGGER_DATA_TYPE_STRING várias cadeias de caracteres que especifica a porta, o protocolo e, opcionalmente, o caminho executável e o nome do serviço que escuta no evento.
SERVICE_TRIGGER_TYPE_GROUP_POLICY Não aplicável.
SERVICE_TRIGGER_TYPE_IP_ADDRESS_AVAILABILITY Não aplicável.
SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT Um SERVICE_TRIGGER_DATA_TYPE_STRING que especifica a porta, o pipe nomeado ou a interface RPC para o ponto de extremidade de rede.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho winsvc.h

Confira também

ChangeServiceConfig2

QueryServiceConfig2

SERVICE_TRIGGER

Eventos de gatilho de serviço