IEventTrigger::p ut_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 put_ValueQueries(
ITaskNamedValueCollection *pNamedXPaths
);
Parameter
pNamedXPaths
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
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | taskschd.h |
Bibliothek | Taskschd.lib |
DLL | Taskschd.dll |