IEventTrigger::put_ValueQueries method (taskschd.h)

Gets or sets a collection of named XPath queries. Each query in the collection is applied to the last matching event XML returned from the subscription query specified in the Subscription property.

This property is read/write.

Syntax

HRESULT put_ValueQueries(
  ITaskNamedValueCollection *pNamedXPaths
);

Parameters

pNamedXPaths

Return value

None

Remarks

The name of the query can be used as a variable in the following action properties:

• MessageBody property of IShowMessageAction
• Title property of IShowMessageAction
• Arguments property of IExecAction
• WorkingDirectory property of IExecAction
• Server property of IEmailAction
• Subject property of IEmailAction
• To property of IEmailAction
• Cc property of IEmailAction
• Bcc property of IEmailAction
• ReplyTo property of IEmailAction
• From property of IEmailAction
• Body property of IEmailAction
• Data property of IComHandlerAction

The following code example strings show two name-value pairs that can be used in a name-value collection. The values returned by the XPath queries can replace variables in an action property. The values are referenced by name, with $(user) and $(machine), in the action property. For example, if the $(user) and $(machine) variables are used in the MessageBody property of IShowMessageAction, then the value of the XPath queries will replace the variables in the string.

name: user
value: Event/UserData/SubjectUserName

name: machine
value: Event/UserData/MachineName

For more information about writing a query string for certain events, see Event Selection and Subscribing to Events.

Requirements

See also

IEventTrigger

ITaskNamedValueCollection

ITaskNamedValuePair