Condividi tramite


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.

Cimtype

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.

Dinamico

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

Vedi anche

Impostazione dei descrittori di sicurezza namepace

Qualificatori WMI

Aggiunta di un qualificatore