Condividi tramite


Qualificatori di proprietà WMI

Nella tabella seguente sono elencati i qualificatori di proprietà MOF obbligatori e facoltativi che possono essere usati per definire gli elementi in un blocco di eventi o dati WMI.

Di seguito sono riportati qualificatori MOF standard: key, read, write, ValueMap e Values. Per altre informazioni su questi e altri qualificatori MOF standard, vedere Tipi di dati MOF.

Qualifier Descrizione

key

Indica che l'elemento di dati è una proprietà chiave che identifica in modo univoco ogni istanza della classe . Solo la proprietà InstanceName può essere dichiarata una chiave.

read

Indica che un client WMI può leggere l'elemento di dati.

write

Indica che un client WMI può impostare l'elemento di dati.

Bitmap

Specifica le posizioni di bit dei valori stringa corrispondenti specificati in BitValues.

BitValues

Specifica un elenco di valori stringa (nomi di flag) che rappresentano i bit impostati nell'elemento di dati. La posizione di bit di un flag è definita dalla posizione corrispondente specificata in BitMap.

DefineValues

Specifica un elenco enumerato compilato dalla suite di strumenti WMI in un elenco corrispondente di istruzioni #define.

DisplayInHex

Specifica che qualsiasi client WMI che visualizza il valore della proprietà deve farlo in formato esadecimale.

DisplayName("string")

Specifica una didascalia che un client WMI può usare per visualizzare come nome della proprietà.

MaxLen(uint)

Per le proprietà stringa, MaxLen specifica la lunghezza massima della stringa in caratteri. Il valore uint può essere qualsiasi intero senza segno a 32 bit. Se MaxLen viene omesso o uint è zero, la lunghezza della stringa è illimitata.

Valori

Specifica un elenco di valori possibili per questo elemento di dati. Se l'elemento dati è un'enumerazione, ValueMap contiene il valore di indice corrispondente al valore di enumerazione specificato in Values.

ValueMap

Specifica i valori interi dei valori stringa corrispondenti in Valori.

WmiDataId(data-item-ID)

(Obbligatorio) Identifica un elemento di dati all'interno di un blocco di dati. Gli ID elemento di dati devono essere assegnati a tutti gli elementi di un blocco, ad eccezione degli elementi necessari InstanceName e Active. Gli ID elemento dati devono essere assegnati in una serie contigua, a partire da 1. L'ID dati di un elemento determina l'ordine in cui l'elemento viene visualizzato in un'istanza del blocco di dati; l'ordine degli elementi nella definizione della classe MOF è irrilevante.

WmiMethodId(method-item-ID)

Identifica un metodo all'interno di un blocco di dati.

WmiSizeIs("data-item-name")

Specifica il nome di un altro elemento di dati in questo blocco che indica il numero di elementi nella matrice a lunghezza variabile in questo elemento di dati. WmiSizeIs è valido solo per gli elementi di dati che definiscono matrici.

WmiScale(scale-factor)

Specifica il fattore di ridimensionamento, come potenza pari a 10, che il driver utilizza quando restituisce il valore di questo elemento di dati. Ad esempio, se il fattore di scala è 5, il valore restituito dal driver viene moltiplicato per 10⁵. Se WmiScale viene omesso, il fattore di scala può essere considerato 0.

WmiTimeStamp

Specifica che un elemento dati a 64 bit è un timestamp in unità di 100 nanosecondi dal 1/1/1601. WmiTimeStamp è valido solo per gli elementi di dati a 64 bit.

WmiComplexity(level)

Specifica un valore intero che esprime il livello di complessità dell'utente dell'elemento di dati. I client WMI possono usare tale valore per distinguere gli elementi di dati che devono essere disponibili per gli utenti principianti e gli elementi di dati che devono essere limitati a utenti più avanzati. Zero è il valore minimo e i valori più alti indicano una maggiore complessità dell'utente. Il valore predefinito di WmiComplexity è zero se non specificato.

WmiVolatility(interval)

Specifica l'intervallo, espresso in millisecondi, tra gli aggiornamenti di questo elemento di dati. Ad esempio, se un elemento di dati viene aggiornato una volta al secondo, l'intervallo sarà 1000. Un client WMI potrebbe controllare WmiVolatility per determinare la frequenza con cui eseguire una query per un valore potenzialmente nuovo. Se WmiVolatility viene omesso, l'intervallo non è definito.

WmiEventTrigger( " data-item-name")

Specifica il nome di un elemento di dati in un blocco di eventi che un client WMI può impostare per definire il valore del trigger per l'evento. Ad esempio, se l'evento TooHot è qualificato con WmiEventTrigger("TooHotTemperature"), un client WMI potrebbe impostare TooHotTemperature per indicare al driver di inviare l'evento TooHot quando il dispositivo ha raggiunto il valore specificato dall'utente per TooHotTemperature. In genere, un driver definirà il valore del trigger. Esponendo un elemento di dati WmiEventTrigger , il driver consente a un client di controllare quando viene generato un determinato evento.

WmiEventRate("data-item-name")

Specifica il nome di un elemento di dati in un blocco eventi che un client WMI può impostare per controllare la frequenza con cui verrà inviato questo evento. Ad esempio, se l'elemento di dati TooHot è qualificato con WmiEventRate("SendEventRate"), un utente client WMI potrebbe impostare SendEventRate per indicare al driver di inviare TooHot all'intervallo specificato dall'utente.