Qualificatori standard
Tutte le implementazioni conformi a CIM devono gestire un set standard di qualificatori. Per qualsiasi oggetto specifico non sono elencati tutti i qualificatori. In genere, le classi di estensione forniscono qualificatori aggiuntivi per facilitare il provisioning di istanze di classe e altre operazioni sulla classe .
È responsabilità del provider applicare i qualificatori. WMI non applica qualificatori, ma li usa solo per informare l'utente del modo in cui viene utilizzata la proprietà.
Nota
WMI è conforme alla specifica CIM 2.5.
I qualificatori presentano le limitazioni seguenti:
- Non tutti i qualificatori standard possono essere usati insieme.
- Non tutti i qualificatori possono essere applicati a tutti i costrutti, ad esempio l'associazione o il riferimento. Queste limitazioni sono identificate nell'elenco Si applica a .
- Per un particolare costrutto, ad esempio l'associazione o il riferimento, l'uso dei qualificatori legali può essere ulteriormente vincolato perché alcuni qualificatori si escludono a vicenda, l'uso di un qualificatore può implicare alcune restrizioni sul valore di un altro e così via. Queste regole di utilizzo sono documentate.
- I qualificatori legali vengono ereditati da entità come proprietà, metodi, istanze o sottoclassi solo, non da associazioni o riferimenti. Ad esempio, il qualificatore MaxLen applicabile alle proprietà non viene ereditato dai riferimenti.
Di seguito sono elencati i qualificatori standard WMI.
Contenuto
Tipo di dati: booleano
Si applica a: classi, associazioni, indicazioni
Indica se la classe è astratta e funge solo da base per le nuove classi. Il valore predefinito è FAL edizione Standard. Non è possibile creare istanze di classi astratte. L'assenza di questo qualificatore indica che la classe non è astratta; pertanto, questo qualificatore è necessario per tutte le classi astratte.
Aggregazione
Tipo di dati: booleano
Si applica a: riferimenti
Indica se il riferimento è il componente padre di un'associazione di aggregazione. Il valore predefinito è FAL edizione Standard.
Utilizzo: i qualificatori aggregazione e aggregazione vengono usati insieme Aggregazione qualifica l'associazione e Aggregate specifica il riferimento padre.
Aggregazione
Tipo di dati: booleano
Si applica a: associazioni
Indica se l'associazione è un'aggregazione. Il valore predefinito è FAL edizione Standard. Usato con Aggregate. Questo qualificatore è obbligatorio per tutte le associazioni di aggregazione.
Alias
Tipo di dati: string
Si applica a: proprietà, riferimenti, metodi
Nome alternativo per una proprietà o un metodo nello schema. Il valore predefinito è NULL.
ArrayType
Tipo di dati: string
Si applica a: proprietà, parametri
Tipo della matrice qualificata.
Valori validi:
- borsa (impostazione predefinita)
- Indicizzato
- ordered
Utilizzo: applicare questo tipo di qualificatore solo alle proprietà e ai parametri che sono matrici (definite usando la sintassi tra parentesi quadre).
Bitmap
Tipo di dati: matrice di stringhe
Si applica a: proprietà, metodi, parametri
Mappa di posizioni di bit significative in cui ogni posizione significativa può essere "on" o "off". Ogni bit "on" esegue il mapping a un valore corrispondente nella matrice BitValues . Se sono presenti più bit "on", sono indicati più valori simultanei nella matrice BitValues . Il valore predefinito è NULL.
Per altre informazioni, vedere BitMap e BitValues.
BitValues
Tipo di dati: matrice di stringhe
Si applica a: proprietà, metodi, parametri
Conversione di un valore di posizione di bit in una stringa associata. Il valore predefinito è NULL.
Per altre informazioni, vedere BitMap e BitValues.
Costruttore
Tipo di dati: booleano
Si applica a: metodi
Indica se il metodo crea istanze. Questi metodi non sono vincolati a agire su una singola istanza o su una singola classe. Ad esempio, un costruttore può creare istanze di associazione e istanze della classe che definisce il costruttore.
Il qualificatore del costruttore è destinato solo alle informazioni e non è previsto che venga usato dal gestore oggetti. Il gestore oggetti non deve chiamare i metodi del costruttore quando viene creato un oggetto . Inoltre, quando viene chiamato un costruttore, il gestore oggetti non deve richiamare metodi del costruttore definiti per qualsiasi classe padre della classe originale. Il valore predefinito è FAL edizione Standard.
CreateBy
Tipo di dati: string
Si applica a: classi
Nome del metodo in base al quale vengono create le istanze di questa classe. Il valore è "PutInstance" o il nome di un altro metodo che crea le istanze. Il valore predefinito è NULL.
Utilizzo: questo qualificatore può essere usato solo se è presente il qualificatore SupportsCreate .
DeleteBy
Tipo di dati: string
Si applica a: classi
Nome del metodo in base al quale vengono eliminate le istanze di questa classe. Il valore è "DeleteInstance" o il nome di un altro metodo che elimina le istanze. Il valore predefinito è NULL.
Utilizzo: questo qualificatore può essere usato solo se è presente il qualificatore SupportsDelete .
Descrizione
Tipo di dati: string
Si applica a: qualsiasi
Descrizione di un elemento denominato. Il valore predefinito è NULL.
Distruttore
Tipo di dati: booleano
Si applica a: metodi
Indica se il metodo elimina le istanze. I metodi che usano il qualificatore distruttore eliminano le istanze a cui viene applicato il distruttore e non sono vincolati a agire su una singola istanza o classe. Ad esempio, un distruttore può eliminare istanze di associazione e istanze della classe che definisce il distruttore.
Il qualificatore distruttore è destinato solo alle informazioni e non è previsto che venga eseguito dal gestore oggetti. Non è necessario che il gestore oggetti chiami un metodo con qualificatore distruttore quando un'istanza viene eliminata. Inoltre, quando viene chiamato un distruttore, il gestore oggetti non deve richiamare metodi distruttori definiti per qualsiasi classe padre della classe originale. Il valore predefinito è FAL edizione Standard.
DisplayName
Tipo di dati: string
Si applica a: qualsiasi
Nome visualizzato nell'interfaccia utente anziché il nome effettivo dell'elemento. Il valore predefinito è NULL.
EmbeddedInstance
Tipo di dati: string
Si applica a: qualsiasi
L'elemento di tipo stringa qualificato contiene un'istanza incorporata. Il valore del qualificatore specifica il nome di una classe CIM nello stesso spazio dei nomi della classe proprietaria dell'elemento qualificato. L'istanza incorporata è un'istanza della classe specificata, incluse le istanze delle relative sottoclassi. Il valore predefinito è NULL.
Misuratore
Tipo di dati: booleano
Si applica a: qualsiasi
Indica se la proprietà rappresenta un numero intero non negativo, che può aumentare o diminuire, ma non superare mai un valore massimo. Il valore predefinito è FAL edizione Standard.
Il valore massimo della proprietà non può essere maggiore di 2^n - 1. N può essere 8, 16, 32 o 64 a seconda del tipo di dati della proprietà a cui viene applicato questo qualificatore. Il valore di un misuratore ha il valore massimo ogni volta che le informazioni modellate sono maggiori o uguali a tale valore massimo. Se le informazioni modellate successivamente diminuiscono al di sotto del valore massimo, anche il misuratore diminuisce. Questo qualificatore è applicabile solo alle proprietà con un tipo di dati integer senza segno.
In
Tipo di dati: booleano
Si applica a: parametri
Indica se il parametro viene utilizzato per passare valori a un metodo. Il valore predefinito è TRUE.
In uscita
Tipo di dati: booleano
Si applica a: parametri
Indica se il parametro è sia un parametro di input che di output.
Tipo di dati: booleano
Si applica a: proprietà, riferimenti
Indica se la proprietà fa parte dell'handle dello spazio dei nomi. Se più di una proprietà ha il qualificatore Key , tutte queste proprietà formano collettivamente la chiave (una chiave composta). Se insieme, le proprietà chiave devono fornire un riferimento univoco per ogni istanza di classe. Se questo qualificatore viene inserito in una proprietà, è consentito solo il valore TRUE .
Differita
Si applica a: proprietà
Indica che la proprietà è a elevato utilizzo di risorse da restituire e richiede molto tempo del processore e memoria. WMI migliora le prestazioni delle query non tentando di restituire le proprietà contrassegnate con il qualificatore Differita .
MappingStrings
Tipo di dati: matrice di stringhe
Si applica a: classi, proprietà, associazioni, indicazioni, riferimenti
Set di valori che indicano un percorso a una posizione in cui è possibile trovare altre informazioni sull'origine di una proprietà, una classe, un'associazione, un'indicazione o un riferimento. La stringa di mapping può essere un percorso di directory, un URL, una chiave del Registro di sistema, un file di inclusione, un riferimento a una classe CIM o un altro formato. Il valore predefinito è NULL.
Max
Tipo di dati: int
Si applica a: riferimenti
Il numero massimo di valori che un riferimento specificato può avere per ogni set di altri valori di riferimento nell'associazione. Il valore predefinito è NULL. Ad esempio, se un'associazione correla istanze A a istanze B e deve essere presente al massimo un'istanza A per ogni istanza B, il riferimento a A deve avere un massimo di un qualificatore.
MaxLen
Tipo di dati: int
Si applica a: proprietà, metodi, parametri
Lunghezza massima (in caratteri) di un elemento di dati stringa e indica il supporto di matrici a lunghezza fissa.
Se viene rilevata una matrice a lunghezza fissa, il qualificatore MaxLen contiene la lunghezza fissa trovata durante l'analisi. Se viene rilevata una matrice a lunghezza variabile, questo qualificatore non viene usato. MaxLen viene usato per suggerire il numero massimo di elementi che devono essere archiviati in una matrice. Quando si esegue l'override del valore predefinito, è possibile specificare qualsiasi valore intero senza segno (uint32). Un valore NULL (impostazione predefinita) implica una lunghezza illimitata.
Maxvalue
Tipo di dati: int
Si applica a: proprietà, metodi, parametri
Valore massimo dell'oggetto. Il valore predefinito è NULL.
Min
Tipo di dati: int
Si applica a: riferimenti
Cardinalità minima del riferimento (il numero minimo di valori che un riferimento specificato può avere per ogni set di altri valori di riferimento nell'associazione). Il valore predefinito è 0.
Ad esempio, se un'associazione correla istanze A a istanze B e deve essere presente almeno un'istanza A per ogni istanza B, il riferimento a A deve avere almeno un qualificatore.
Minvalue
Tipo di dati: int
Si applica a: proprietà, metodi, parametri
Indica il valore minimo dell'oggetto. Il valore predefinito è NULL.
ModelCorrespondence
Tipo di dati: matrice di stringhe
Si applica a: proprietà
Set di valori che indicano la corrispondenza tra la proprietà di un oggetto e altre proprietà nello schema CIM. Il valore predefinito è NULL.
Le proprietà dell'oggetto vengono identificate usando la sintassi seguente.
<nome> schema "_" <classe o nome> associazione "." <nome proprietà>
Non locale
Tipo di dati: string
Si applica a: riferimenti
Posizione di un'istanza, il cui valore è <namespacetype>://<namespacehandle> Il valore predefinito è NULL.
Utilizzo: questo qualificatore non può essere usato con il qualificatore NonlocalType .
NonlocalType
Tipo di dati: string
Si applica a: riferimenti
Tipo di posizione di un'istanza. Il valore è <namespacetype>. Il valore predefinito è NULL.
Utilizzo: questo qualificatore non può essere usato con il qualificatore non locale .
Nullvalue
Tipo di dati: string
Si applica a: proprietà
Valore che indica che la proprietà associata è NULL (la proprietà non ha un valore valido o significativo). Il valore predefinito è NULL.
Le convenzioni e le restrizioni usate per la definizione dei valori NULL sono uguali a quelle applicabili al qualificatore ValueMap . Si noti che questo qualificatore non può essere sottoposto a override. Non è possibile consentire a una sottoclasse di restituire un valore NULL diverso da quello della classe padre.
Verso l'esterno
Tipo di dati: booleano
Si applica a: parametri
Indica se il parametro restituisce valori da un metodo. Il valore predefinito è FAL edizione Standard.
Override
Tipo di dati: string
Si applica a: proprietà, metodi, riferimenti
Classe padre o costrutto subordinato (proprietà, metodo o riferimento) sottoposto a override dalla proprietà, dal metodo o dal riferimento dello stesso nome nella classe derivata. Il valore predefinito è NULL.
Il formato è:
[<classe>.]<costrutto subordinato>
Se il nome della classe viene omesso, l'override si applica al costrutto subordinato nella classe padre nella gerarchia di classi.
Utilizzo: il qualificatore override può fare riferimento a costrutti basati solo sullo stesso modello meta. Non è consentito modificare un nome di costrutto o una firma durante un'operazione di override.
OverrideValue
Si applica a: classi
Indica se il valore della proprietà in una sottoclasse esegue l'override del valore in una classe padre. L'implicazione funzionale è che, se si esegue una query sulla classe padre e se la clausola WHERE include questa proprietà, l'elemento padre deve restituire un'istanza con il valore sottoposto a override. Di conseguenza, Gestione Windows regola la clausola WHERE della query inviata alla classe padre per escludere i riferimenti a questa proprietà.
Propagate
Tipo di dati: string
Si applica a: proprietà
Nome della chiave propagata. Il valore predefinito è NULL.
L'uso di questo qualificatore presuppone l'esistenza di un solo qualificatore debole su un riferimento con la classe contenitore come destinazione. La proprietà associata deve avere lo stesso valore della proprietà denominata dal qualificatore nella classe dall'altra parte dell'associazione debole. Il formato è:
[<classe>.]<costrutto subordinato>
Utilizzo: quando viene usato il qualificatore Propagated , il qualificatore chiave deve essere specificato con un valore TRUE.
Lettura
Tipo di dati: booleano
Si applica a: proprietà
Indica se la proprietà è leggibile. Il valore predefinito è TRUE.
Obbligatorio
Tipo di dati: booleano
Si applica a: proprietà
Indica se per la proprietà è necessario un valore non Null. Il valore predefinito è FAL edizione Standard.
Revisione
Tipo di dati: string
Si applica a: classi, associazioni, indicazioni, schemi
Numero di revisione secondario dell'oggetto schema. Il valore predefinito è NULL.
Utilizzo: il qualificatore di versione deve essere presente per specificare il numero di versione principale quando viene usato il qualificatore revisione .
Schema
Tipo di dati: string
Si applica a: proprietà, metodi
Nome dello schema in cui è definita la funzionalità. Il valore predefinito è NULL.
Origine
Tipo di dati: string
Si applica a: classi, associazioni, indicazioni, riferimenti
Posizione di un'istanza. Il valore predefinito è NULL.
Il valore del qualificatore è <namespacetype>://<namespacehandle>.
Utilizzo: il qualificatore di origine non può essere usato con il qualificatore SourceType .
SourceType
Tipo di dati: string
Si applica a: classi, associazioni, indicazioni, riferimenti
Tipo di posizione di un'istanza. Il valore di questo qualificatore è <namespacetype>. Il valore predefinito è NULL.
Utilizzo: il qualificatore SourceType non può essere usato con il qualificatore Source .
SupportsCreate
Tipo di dati: booleano
Si applica a: classi
Indica se la classe supporta la creazione di istanze. Il valore predefinito è FAL edizione Standard.
SupportsDelete
Tipo di dati: booleano
Si applica a: classi
Indica se la classe supporta l'eliminazione di istanze. Il valore predefinito è FAL edizione Standard.
SupportsUpdate
Tipo di dati: booleano
Si applica a: classi
Indica se la classe supporta la modifica (aggiornamento) delle istanze. Il valore predefinito è FAL edizione Standard.
Terminale
Tipo di dati: booleano
Si applica a: classi
Indica se la classe può avere sottoclassi. Il valore predefinito è FAL edizione Standard.
Se viene dichiarata una sottoclasse, il compilatore genera un errore.
Utilizzo: questo qualificatore non può coesistere con il qualificatore Abstract . Se vengono specificati entrambi i qualificatori Terminal e Abstract , il compilatore genera un errore.
Unità
Tipo di dati: string
Si applica a: proprietà, metodi, parametri
Tipo di unità in cui viene espresso l'elemento di dati associato. Il valore predefinito è NULL.
Ad esempio, un elemento di dati delle dimensioni potrebbe avere un valore "byte" per unità.
ValueMap
Tipo di dati: matrice di stringhe
Si applica a: proprietà, metodi, parametri
Set di valori consentiti per una proprietà, un tipo restituito del metodo o un parametro del metodo. Il valore predefinito è NULL.
Utilizzo: questo qualificatore può essere usato da solo o in combinazione con il qualificatore Valori . Se usato in combinazione con il qualificatore Values , la posizione del valore nella matrice ValueMap fornisce la posizione della voce corrispondente nella matrice Values . Usare il qualificatore ValueMap solo con valori stringa e integer. La sintassi per rappresentare un valore intero nella matrice della mappa dei valori è [+|=]digit[*digit]. Il contenuto, il numero massimo di cifre e il valore rappresentato sono vincolati dal tipo della proprietà associata. Ad esempio, uint8 potrebbe non essere firmato, deve essere minore di quattro cifre e deve rappresentare un valore minore di 256.
Valori
Tipo di dati: matrice di stringhe
Si applica a: proprietà, metodi, parametri
Set di valori che converte un valore intero in una stringa associata. Il valore predefinito è NULL.
Questa proprietà specifica anche una matrice di valori stringa di cui eseguire il mapping a una proprietà di enumerazione. Questo qualificatore può essere applicato a una proprietà integer o a una proprietà stringa e il mapping può essere implicito o esplicito. Se il mapping è implicito, i valori delle proprietà integer o stringa rappresentano le posizioni ordinali nella matrice Values . Se il mapping è esplicito, la proprietà deve essere un numero intero e i valori validi della proprietà sono elencati nella matrice definita dal qualificatore ValueMap . Per altre informazioni, vedere Mappa valori.
Se non è presente un qualificatore ValueMap , la matrice Values viene indicizzata (relativa zero) usando il valore nella proprietà associata, il tipo restituito del metodo o il parametro del metodo. Se è presente un qualificatore ValueMap , l'indice dei valori viene definito dalla posizione del valore della proprietà nella mappa dei valori.
Versione
Tipo di dati: string
Si applica a: classi, schemi, associazioni, indicazioni
Numero di versione principale dell'oggetto schema. Il valore predefinito è NULL. Il numero di versione viene incrementato quando vengono apportate modifiche allo schema che modificano l'interfaccia.
Debole
Tipo di dati: booleano
Si applica a: riferimenti
Indica se le chiavi della classe a cui viene fatto riferimento includono le chiavi degli altri partecipanti all'associazione. Il valore predefinito è FAL edizione Standard.
Questo qualificatore viene usato quando l'identità della classe a cui si fa riferimento dipende dall'identità degli altri partecipanti dell'associazione. Nessun riferimento a una determinata classe può essere debole. Le altre classi nell'associazione devono definire una chiave. Le chiavi delle altre classi nell'associazione vengono ripetute nella classe a cui si fa riferimento e vengono contrassegnate con un qualificatore Propagated .
Scrittura
Tipo di dati: booleano
Si applica a: proprietà
Indica che le applicazioni o gli script possono modificare il valore della proprietà. L'account che esegue l'applicazione deve avere accesso allo spazio dei nomi che contiene istanze della classe . L'implementazione del provider può anche limitare l'accesso ai dati del provider. Un valore TRUE indica che la proprietà è leggibile e scrivibile dai consumer a cui è consentito l'accesso da WMI e dal provider. Il valore predefinito è FAL edizione Standard.
Una proprietà che non dispone del qualificatore di scrittura può comunque essere scrivibile. L'implementazione del provider può consentire la modifica di qualsiasi proprietà nelle classi del provider, indipendentemente dal fatto che sia presente il qualificatore di scrittura .
WriteAtCreate
Tipo di dati: booleano
Si applica a: proprietà
Indica se la proprietà è scrivibile durante la creazione dell'istanza. Questo qualificatore può essere usato insieme al qualificatore WriteAtCreate . Il valore predefinito è FAL edizione Standard.
WriteAtUpdate
Tipo di dati: booleano
Si applica a: proprietà
Indica se la proprietà è scrivibile in fase di aggiornamento dell'istanza. Questo qualificatore può essere usato insieme al qualificatore WriteAtCreate . Il valore predefinito è FAL edizione Standard.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |