Qualificatori specifici del provider di visualizzazioni

Di seguito sono elencati i qualificatori usati per definire le classi del provider di visualizzazione.

Nota

La classe del provider View supporta solo i nomi NetBIOS quando si usano riferimenti remoti. Se si usa un indirizzo IP o un nome DNS in un riferimento remoto, la connessione ha esito negativo con un errore di 0x800706ba.

Diretto

Tipo di dati: booleano

Utilizzato con le proprietà di associazione di visualizzazione per impedire il mapping dei riferimenti di associazione a un riferimento di visualizzazione.

Nell'esempio seguente viene definita la proprietà GroupComponent come riferimento di associazione non mappata nel riferimento alla vista.

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

HiddenDefault

Tipo di dati: booleano

Valore predefinito per una proprietà della classe di visualizzazione basata su una proprietà della classe di origine con un valore predefinito diverso. La classe di origine sottostante è implicita dalla vista.

Ad esempio, la classe di origine Win32_ScheduledJob ha una proprietà booleanaRunRepeated che indica se il processo deve essere eseguito periodicamente o una sola volta. Il valore predefinito di RunRepeatedly non è True per Win32_ScheduledJob, ma è True per la classe di visualizzazione.

#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

Tipo di dati: string

Definisce il modo in cui le istanze della classe di origine vengono unite in join nelle classi di visualizzazione join. Nell'esempio seguente viene illustrato come usare il qualificatore JoinOn per unire due classi di origine.

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

MethodSource

Tipo di dati: matrice di stringhe

Metodo di origine da eseguire per il metodo view. Per una sintassi simile, vedere PropertySources Qualifier. La firma del metodo deve corrispondere esattamente alla firma della classe di origine. Copiare la firma del metodo dal file MOF che definisce la classe di origine. L'esempio seguente definisce un metodo dal metodo ClearEventLog di Win32_NTEventlogFile:

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

Questo qualificatore è valido solo quando viene usato con le visualizzazioni unione.

PostJoinFilter

Tipo di dati: string

Query WQL per filtrare le istanze dopo che sono state aggiunte a una classe join.

PropertySources

Tipo di dati: matrice di stringhe

Proprietà di origine da cui una proprietà della classe di visualizzazione ottiene i dati.

Unione

Tipo di dati: booleano

Indica se si definisce una classe union. Le viste unione contengono istanze basate sull'unione delle istanze di origine. Ad esempio, è possibile dichiarare quanto segue:

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

ViewSources

Tipo di dati: matrice di stringhe

Set di query WQL (WMI Query Language) che definiscono le istanze di origine e le proprietà usate in una classe di visualizzazione specifica. La corrispondenza posizionale di tutti i qualificatori di matrice è importante.

ViewSpaces

Tipo di dati: matrice di stringhe

Spazi dei nomi in cui si trovano le istanze di origine.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008