IEventTrigger ::p ut_ValueQueries, méthode (taskschd.h)
Obtient ou définit une collection de requêtes XPath nommées. Chaque requête de la collection est appliquée au dernier XML d’événement correspondant retourné par la requête d’abonnement spécifiée dans la propriété Subscription .
Cette propriété est en lecture/écriture.
Syntaxe
HRESULT put_ValueQueries(
ITaskNamedValueCollection *pNamedXPaths
);
Paramètres
pNamedXPaths
Valeur de retour
None
Remarques
Le nom de la requête peut être utilisé comme variable dans les propriétés d’action suivantes :
- Propriété MessageBody de IShowMessageAction
- Propriété Title de IShowMessageAction
- Propriété Arguments de IExecAction
- Propriété WorkingDirectory de IExecAction
- Propriété serveur de IEmailAction
- Propriété Subject de IEmailAction
- To, propriété de IEmailAction
- Propriété Cc de IEmailAction
- Propriété Cci de IEmailAction
- Propriété ReplyTo de IEmailAction
- Propriété From de IEmailAction
- Propriété Body de IEmailAction
- Propriété data de IComHandlerAction
Les exemples de chaînes de code suivants montrent deux paires nom-valeur qui peuvent être utilisées dans une collection nom-valeur. Les valeurs retournées par les requêtes XPath peuvent remplacer des variables dans une propriété d’action. Les valeurs sont référencées par nom, avec $(utilisateur) et $(machine), dans la propriété action. Par exemple, si les variables $(utilisateur) et $(machine) sont utilisées dans la propriété MessageBody de IShowMessageAction, la valeur des requêtes XPath remplace les variables dans la chaîne.
name: user
value: Event/UserData/SubjectUserName
name: machine
value: Event/UserData/MachineName
Pour plus d’informations sur l’écriture d’une chaîne de requête pour certains événements, consultez Sélection d’événements et Abonnement aux événements.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | taskschd.h |
| Bibliothèque | Taskschd.lib |
| DLL | Taskschd.dll |