estrutura SERVICE_TRIGGER_SPECIFIC_DATA_ITEM (winsvc.h)
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.
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 |