IEventTrigger::get_ValueQueries-Methode (taskschd.h)

Ruft eine Auflistung von benannten XPath-Abfragen ab oder legt diese fest. Jede Abfrage in der Auflistung wird auf die letzte übereinstimmende Ereignis-XML angewendet, die von der in der Subscription-Eigenschaft angegebenen Abonnementabfrage zurückgegeben wird.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_ValueQueries(
  ITaskNamedValueCollection **ppNamedXPaths
);

Parameter

ppNamedXPaths

Rückgabewert

Keine

Bemerkungen

Der Name der Abfrage kann als Variable in den folgenden Aktionseigenschaften verwendet werden:

• MessageBody-Eigenschaft von IShowMessageAction
• Title-Eigenschaft von IShowMessageAction
• Arguments-Eigenschaft von IExecAction
• WorkingDirectory-Eigenschaft von IExecAction
• Servereigenschaft von IEmailAction
• Subject-Eigenschaft von IEmailAction
• To-Eigenschaft von IEmailAction
• Cc-Eigenschaft von IEmailAction
• Bcc-Eigenschaft von IEmailAction
• ReplyTo-Eigenschaft von IEmailAction
• From-Eigenschaft von IEmailAction
• Body-Eigenschaft von IEmailAction
• Data-Eigenschaft von IComHandlerAction

Die folgenden Codebeispielzeichenfolgen zeigen zwei Name-Wert-Paare, die in einer Name-Wert-Auflistung verwendet werden können. Die von den XPath-Abfragen zurückgegebenen Werte können Variablen in einer Aktionseigenschaft ersetzen. Auf die Werte wird anhand des Namens mit $(user) und $(machine) in der Aktionseigenschaft verwiesen. Wenn beispielsweise die Variablen $(user) und $(machine) in der MessageBody-Eigenschaft von IShowMessageAction verwendet werden, ersetzt der Wert der XPath-Abfragen die Variablen in der Zeichenfolge.

name: user
value: Event/UserData/SubjectUserName

name: machine
value: Event/UserData/MachineName

Weitere Informationen zum Schreiben einer Abfragezeichenfolge für bestimmte Ereignisse finden Sie unter Ereignisauswahl und Abonnieren von Ereignissen.

Anforderungen

Weitere Informationen

IEventTrigger

ITaskNamedValueCollection

ITaskNamedValuePair