Qualificatori WMI standard
Di seguito sono elencati i qualificatori standard specifici di WMI.
Emendamento
Tipo di dati: booleano
Si applica a: classi
Indica che una classe contiene qualificatori modificati localizzati. Il valore predefinito è TRUE.
La classe associata può essere tradotta. Per accedere alla versione tradotta, usare l'identificatore delle impostazioni locali per costruire un nome dello spazio dei nomi.
Bypass_GetObject
Tipo di dati: booleano
Si applica a: metodi
Indica che la chiamata al metodo deve passare direttamente alla chiamata ExecMethodAsync del provider anziché al provider prima di eseguire una chiamata a GetObject per convalidare il percorso dell'oggetto. Il valore predefinito è FALSE. L'uso di Bypass_GetObject può migliorare significativamente le prestazioni.
Prima di usare Bypass_GetObject, assicurarsi che non vengano eseguite alcuna delle azioni seguenti:
- Derivare una classe dalla classe .
- Eseguire l'override del metodo con il qualificatore Bypass_GetObject .
Se non si seguono queste precauzioni, è possibile richiamare l'implementazione del metodo della classe padre anziché la classe figlio. Per altre informazioni, vedere Uso del qualificatore Bypass_GetObject.
CIM_Key
Tipo di dati: CIM_BOOLEAN
Si applica a: proprietà
Indica che la proprietà associata è una proprietà chiave in CIM ma non in WMI.
Tipo di dati: VT_BSTR
Si applica a: proprietà, metodi, parametri
Contiene testo che descrive il tipo di una proprietà.
ClassContext
Tipo di dati: VT_BSTR
Si applica a: classi
Indica che a una classe sono associate istanze associate altre informazioni fornite dinamicamente da un provider.
Deprecato
Tipo di dati: CIM_BOOLEAN
Si applica a: proprietà, classi
Indica che la proprietà è stata sostituita da un'altra proprietà.
Visualizzazione
Si applica a: classi, proprietà
UUID della classe associata.
Tipo di dati: booleano
Si applica a: classi, proprietà
Indica una classe le cui istanze vengono create in modo dinamico. Il valore di questo qualificatore deve essere impostato su TRUE.
DynProps
Tipo di dati: booleano
Si applica a: classi, istanze
Indica che un'istanza contiene valori forniti dai provider di proprietà dinamiche. Il valore predefinito è TRUE.
È necessario specificare questo qualificatore in un'istanza di questo tipo. È consentito solo il valore TRUE .
Fisso
Tipo di dati: CIM_BOOLEAN
Si applica a: istanze
Indica che il valore di questa proprietà non può essere modificato durante la durata dell'istanza.
ID
Tipo di dati: VT_I4
Si applica a: proprietà, parametri
Identifica in modo univoco e sequenza un parametro di proprietà o metodo quando le istruzioni MOF vengono generate automaticamente.
Questo qualificatore è obbligatorio solo per i parametri del metodo. Quando si creano parametri per un metodo, le finestre di progettazione classi devono iniziare con Id(0) per il primo parametro e usare ogni intero successivo per ogni parametro successivo. Se i qualificatori ID vengono omessi involontariamente, il compilatore MOF genera automaticamente qualificatori ID .
Implementato
Tipo di dati: booleano
Si applica a: metodi
Indica che un metodo dispone di un'implementazione fornita da un provider.
Instancecontext
Tipo di dati: VT_BSTR
Si applica a: istanze
Indica che un'istanza contiene valori forniti da un provider di proprietà dinamiche.
Il valore viene passato al provider di proprietà come argomento al metodo IWbemPropertyProvider::GetProperty .
Impostazioni internazionali
Tipo di dati: VT_BSTR
Si applica a: classi o istanze
Specifica il linguaggio di origine per una classe o un'istanza. Per altre informazioni sui valori delle impostazioni locali, vedere Codici delle impostazioni locali.
NamespaceSecuritySDDL
Tipo di dati: matrice di stringhe
Si applica a: istanze dello spazio dei nomi
Specifica un descrittore di sicurezza per lo spazio dei nomi in formato SDDL . Per altre informazioni, vedere Impostazione della sicurezza dello spazio dei nomi quando viene creato lo spazio dei nomi. La stringa SDDL viene elaborata da WMI per stabilire la sicurezza dello spazio dei nomi, ma non archiviata come stringa. Se non viene specificato alcun descrittore di sicurezza, viene usata la sicurezza predefinita. Per altre informazioni, vedere Impostazione dei descrittori di sicurezza namepace.
Opzionale
Tipo di dati: booleano
Si applica a: parametri
Indica che un parametro non è obbligatorio e che ha un valore predefinito ben comportamento.
Privilegi
Tipo di dati: matrice di stringhe
Si applica a: proprietà, metodi
Set di valori usati per informare il client quali privilegi sono necessari per creare istanze, compilare proprietà o eseguire metodi. Il valore predefinito è FALSE.
PropertyContext
Tipo di dati: VT_BSTR
Si applica a: proprietà
Indica che una proprietà dell'istanza contiene valori forniti dai provider di proprietà dinamiche.
È necessario specificare questo qualificatore in una proprietà di questo tipo. Il valore viene passato al provider di proprietà come argomento a IWbemPropertyProvider::GetProperty.
Provider
Tipo di dati: VT_BSTR
Si applica a: classi
Il valore di questo qualificatore è il nome del provider dinamico che fornisce istanze di classe e aggiorna i dati dell'istanza. Questo nome deve essere registrato con WMI creando un'istanza della classe __Win32Provider con la proprietà Name contenente questo nome. Quando questo qualificatore viene specificato in una classe le cui istanze vengono fornite in modo dinamico, è necessario specificare anche il qualificatore dinamico .
RequiresEncryption
Tipo di dati: booleano
Si applica a: istanze dello spazio dei nomi
Se impostato su TRUE, RequiresEncryption contrassegna uno spazio dei nomi in modo che le applicazioni client e gli script debbano connettersi con l'autenticazione crittografata. Il livello di autenticazione deve essere impostato su RPC_C_AUTHN_LEVEL_PKT_PRIVACY in C++. In scripting o Visual Basic, il livello di autenticazione deve essere impostato su WbemAuthenticationLevelPktPrivacy. Per altre informazioni, vedere Impostazione dei descrittori di sicurezza namepace. Il qualificatore viene usato in MOF con il comando preprocessore dello spazio dei nomi pragma.
Per altre informazioni, vedere Impostazione del livello di sicurezza del processo predefinito tramite C++ o Impostazione del livello di sicurezza del processo predefinito tramite VBScript. I livelli di autenticazione di scripting sono definiti in WbemAuthenticationLevelEnum.
Singleton
Tipo di dati: booleano
Si applica a: classi
Definisce una classe che può avere una sola istanza e che non contiene proprietà chiave.
È consentito solo il valore TRUE (impostazione predefinita).
Statico
Tipo di dati: booleano
Si applica a: metodi
Indica se un metodo può essere chiamato utilizzando la definizione della classe o le relative istanze.
Il metodo non può essere richiamato da un'istanza di .
Sottotipo
Tipo di dati: VT_BSTR
Si applica a: proprietà
Indica che una proprietà di tipo CIM_DATETIME rappresenta un intervallo di tempo anziché un'ora specifica.
Per identificare la proprietà come intervallo, il valore di questo qualificatore deve essere "interval". Tutti gli altri valori per questo qualificatore sono riservati per un uso futuro.
UUID
Tipo di dati: string
Si applica a: classi
Identificatore univoco universale applicato alla classe .
ClassVersion
Tipo di dati: string
Si applica a: classi
Numero di versione dell'oggetto classe. Il valore predefinito è NULL. Il numero di versione viene incrementato quando vengono apportate modifiche alla classe .
WritePrivileges
Tipo di dati: matrice di stringhe
Si applica a: proprietà
Set di valori che indicano quali privilegi di sistema devono essere disponibili e abilitati per un'operazione di scrittura riuscita.
Commenti
Codici delle impostazioni locali
Un codice delle impostazioni locali è costituito dal formato "MS_<ID> lingua cifre". Ad esempio, le impostazioni locali in inglese sono MS_409. Nella tabella seguente sono elencati gli ID lingua.
| Linguaggio | ID lingua (esadecimale) |
|---|---|
| Arabo | 401 |
| Portoghese (Brasile) | 416 |
| Cinese (semplificato) | 804 |
| Cinese (tradizionale) | 404 |
| Ceco | 405 |
| Danese | 406 |
| Olandese | 413 |
| Inglese (predefinito) | 409 |
| Finlandese | 40b |
| Francese | 40c |
| Tedesco | 407 |
| Greco | 408 |
| Ebraico | 40d |
| Ungherese | 40e |
| Italiano | 410 |
| Giapponese | 411 |
| Coreano | 412 |
| Norvegese | 414 |
| Polacco | 415 |
| Portoghese (Portogallo) | 816 |
| Russo | 419 |
| Spagnolo | c0a |
| Svedese | 41D |
| Turco | 41f |
Uso del qualificatore di Bypass_GetObject
L'uso del qualificatore Bypass_GetObject in un metodo può generare risultati confusi.
Nell'esempio seguente vengono definite le classi Shape e Circle . Si noti che la classe Circle è derivata dalla classe Shape .
class Shape
{
string Name;
uint32 DrawIt(); // - draws an irregular geometric shape
};
class Circle : Shape
{
uint32 DrawIt(); // - draws a circle
};
La chiamata seguente a ExecMethod usa un oggetto Circle denominato "MyCircle" per disegnare un cerchio.
ExecMethod("Shape.Name='MyCircle'","DrawIt");
Nello scenario precedente WMI chiama GetObject; scopre che "Shape.Name='MyCircle'" è un cerchio; ed esegue l'implementazione Circle di DrawIt. Tuttavia, se si utilizza il qualificatore Bypass_GetObject in DrawIt, WMI non chiama GetObject, non rileva che "Shape.Name='MyCircle'" è un Circle ed esegue l'implementazione shape di DrawIt anziché l'implementazione Circle di DrawIt.
La chiamata seguente a ExecMethod richiama sempre l'implementazione corretta di DrawIt.
ExecMethod("Circle.Name='MyCircle'","DrawIt");
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |