Método IEventTrigger::get_ValueQueries (taskschd.h)
Obtém ou define uma coleção de consultas XPath nomeadas. Cada consulta na coleção é aplicada ao último XML de evento correspondente retornado da consulta de assinatura especificada na propriedade Subscription .
Essa propriedade é leitura/gravação.
Sintaxe
HRESULT get_ValueQueries(
ITaskNamedValueCollection **ppNamedXPaths
);
Parâmetros
ppNamedXPaths
Valor retornado
Nenhum
Comentários
O nome da consulta pode ser usado como uma variável nas seguintes propriedades de ação:
- Propriedade MessageBody de IShowMessageAction
- Propriedade Title de IShowMessageAction
- Propriedade Arguments de IExecAction
- Propriedade WorkingDirectory de IExecAction
- Propriedade server do IEmailAction
- Propriedade Subject de IEmailAction
- Para a propriedade de IEmailAction
- Propriedade Cc de IEmailAction
- Propriedade Bcc de IEmailAction
- Propriedade ReplyTo de IEmailAction
- Da propriedade de IEmailAction
- Propriedade body de IEmailAction
- Propriedade data de IComHandlerAction
As cadeias de caracteres de exemplo de código a seguir mostram dois pares nome-valor que podem ser usados em uma coleção name-value. Os valores retornados pelas consultas XPath podem substituir variáveis em uma propriedade de ação. Os valores são referenciados por nome, com $(user) e $(machine), na propriedade action. Por exemplo, se as variáveis $(user) e $(machine) forem usadas na propriedade MessageBody de IShowMessageAction, o valor das consultas XPath substituirá as variáveis na cadeia de caracteres.
name: user
value: Event/UserData/SubjectUserName
name: machine
value: Event/UserData/MachineName
Para obter mais informações sobre como escrever uma cadeia de caracteres de consulta para determinados eventos, consulte Seleção de eventos e Assinatura de Eventos.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | taskschd.h |
| Biblioteca | Taskschd.lib |
| DLL | Taskschd.dll |