Partager via


Qualificateurs propres au fournisseur de vues

Les qualificateurs utilisés pour définir les classes du fournisseur de vues sont listés ci-dessous.

Notes

La classe du fournisseur de vues prend uniquement en charge les noms NetBIOS dans les références distantes. Si vous utilisez une adresse IP ou un nom DNS dans une référence distante, la connexion échoue avec une erreur 0x800706ba.

Direct

Type de données : boolean (booléen)

Utilisé avec les propriétés d’association de vues pour empêcher les références d’association d’être mappées à une référence de vue.

L’exemple suivant définit la propriété GroupComponent en tant que référence d’association qui n’est pas mappée dans la référence de vue.

[Direct, key, PropertySources
{"GroupComponent"}]

HiddenDefault

Type de données : boolean (booléen)

Valeur par défaut d’une propriété de classe de vues qui est basée sur une propriété de classe source avec une valeur par défaut différente. La classe source sous-jacente est définie implicitement par la vue.

Par exemple, la classe source Win32_ScheduledJob a une propriété booléenneRunRepeatedly qui indique si le travail doit être effectué périodiquement ou une seule fois. La valeur par défaut de RunRepeatedly n’est pas True pour Win32_ScheduledJob, mais elle est True pour la classe de vues.

#pragma namespace("\\\\.\\root\\ns_view")
[Union,
ViewSources{"select * from Win32_ScheduledJob where RunRepeatedly=True"},
ViewSpaces{"\\\\.\\root\\cimv2"},
dynamic,provider("MS_VIEW_INSTANCE_PROVIDER")]
Class View_PeriodicJob
{
 [key, PropertySources{"JobId"}]
 uint32 JobId;
 [PropertySources{"Command"}]
 string Command;
 [HiddenDefault,PropertySources{"RunRepeatedly"}]
 boolean Repeat = True;
};

JoinOn

Type de données : string (chaîne)

Définit la façon dont les instances de la classe source sont jointes dans les classes de vues Join. L’exemple suivant montre comment utiliser le qualificateur JoinOn pour joindre deux classes sources.

JoinOn("Win32Perf_RawProcess.IDProcess = Win32Perf_RawThread.IDProcess")

MethodSource

Type de données : string array (tableau de chaînes)

Méthode source à exécuter pour la méthode view. Pour une syntaxe similaire, consultez Qualificateur PropertySources. La signature de la méthode doit correspondre exactement à la signature de la classe source. Copiez la signature de méthode à partir du fichier MOF qui définit la classe source. L’exemple ci-dessous définit une méthode d’après la méthode ClearEventLog de Win32_NTEventlogFile :

[implemented, MethodSource
{"ClearEventlog"}]
  uint32   VClearEventlog([in] string ArchiveFileName);

Ce qualificateur est valide uniquement s’il est utilisé avec des vues Union.

PostJoinFilter

Type de données : string (chaîne)

Requête WQL pour filtrer les instances après qu’elles ont été jointes dans une classe Join.

PropertySources

Type de données : string array (tableau de chaînes)

Propriétés sources à partir desquelles une propriété de classe de vues obtient des données.

Union

Type de données : boolean (booléen)

Indique si vous définissez une classe Union. Les vues Union contiennent des instances basées sur l’union des instances sources. Par exemple, vous pouvez déclarer ceci :

Union, ViewSources{"SELECT Handle, Name, CreationDate FROM Win32_Process", 
                   "SELECT Caption, Name, ProcessHandle FROM Win32_Thread"}.

ViewSources

Type de données : string array (tableau de chaînes)

Ensemble de requêtes WQL (WMI Query Language) qui définissent les instances sources et les propriétés utilisées dans une classe de vues spécifique. La correspondance positionnelle de tous les qualificateurs du tableau est importante.

ViewSpaces

Type de données : string array (tableau de chaînes)

Espaces de noms où se trouvent les instances sources.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008