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.
Tipo di dati: string
Query WQL per filtrare le istanze dopo che sono state aggiunte a una classe join.
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"}.
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.
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 |