Freigeben über

WMI-Standardqualifizierer

Im Folgenden werden standardqualifizierer aufgeführt, die für WMI spezifisch sind.

Abänderung

Datentyp: Boolescher Wert

Gilt für: Klassen

Gibt an, dass eine Klasse geänderte Qualifizierer enthält, die lokalisiert werden. Der Standardwert ist TRUE.

Die zugeordnete Klasse kann übersetzt werden. Um auf die übersetzte Version zuzugreifen, verwenden Sie den Gebietsschemabezeichner, um einen Namespacenamen zu erstellen.

Bypass_GetObject

Datentyp: Boolescher Wert

Gilt für: Methoden

Gibt an, dass der Methodenaufruf direkt an den ExecMethodAsync-Aufruf des Anbieters übergeben werden soll, anstatt dass der Anbieter zuerst einen Aufruf von GetObject vornimmt, um den Objektpfad zu überprüfen. Der Standardwert ist FALSE-. Die Verwendung von Bypass_GetObject kann die Leistung erheblich verbessern.

Stellen Sie vor der Verwendung von Bypass_GetObject sicher, dass keine der folgenden Aktionen ausgeführt wird:

  • Leiten Sie einen Kurs von Ihrem Kurs ab.
  • Überschreiben Sie die Methode mit dem Bypass_GetObject Qualifizierer.

Wenn Sie diese Vorsichtsmaßnahmen nicht einhalten, kann dies dazu führen, dass anstelle der untergeordneten Klasse die Methodenimplementierung der übergeordneten Klasse aufruft wird. Weitere Informationen finden Sie unter Verwenden des Bypass_GetObject Qualifizierers.

CIM_Key

Datentyp: CIM_BOOLEAN

Gilt für: Eigenschaften

Gibt an, dass die zugeordnete Eigenschaft eine Schlüsseleigenschaft in CIM, aber nicht in WMI ist.

CIMType

Datentyp: VT_BSTR

Gilt für: Eigenschaften, Methoden, Parameter

Enthält Text, der den Typ einer Eigenschaft beschreibt.

ClassContext

Datentyp: VT_BSTR

Gilt für: Klassen

Gibt an, dass eine Klasse Instanzen mit weiteren Informationen verknüpft hat, die dynamisch von einem Anbieter bereitgestellt werden.

Veraltet

Datentyp: CIM_BOOLEAN

Gilt für: Eigenschaften, Klassen

Gibt an, dass die Eigenschaft durch eine andere Eigenschaft ersetzt wurde.

Zeigen

Gilt für: Klassen, Eigenschaften

Die UUID der zugeordneten Klasse.

Dynamisch

Datentyp: Boolescher Wert

Gilt für: Klassen, Eigenschaften

Gibt eine Klasse an, deren Instanzen dynamisch erstellt werden. Der Wert dieses Qualifizierers muss auf TRUE festgelegt werden.

DynProps

Datentyp: Boolescher Wert

Gilt für: Klassen, Instanzen

Gibt an, dass eine Instanz Werte enthält, die von dynamischen Eigenschaftenanbietern bereitgestellt werden. Der Standardwert ist TRUE.

Sie müssen diesen Qualifizierer für eine solche Instanz angeben. Nur der Wert TRUE ist zulässig.

Fest

Datentyp: CIM_BOOLEAN

Gilt für: Instanzen

Gibt an, dass der Wert dieser Eigenschaft während der Lebensdauer der Instanz nicht geändert werden kann.

ID

Datentyp: VT_I4

Gilt für: Eigenschaften, Parameter

Identifiziert und sequenziert einen Eigenschafts- oder Methodenparameter eindeutig, wenn MOF-Anweisungen automatisch generiert werden.

Dieser Qualifizierer ist nur für Methodenparameter erforderlich. Beim Erstellen von Parametern für eine Methode sollten Klassendesigner mit ID(0) für den ersten Parameter beginnen und jede aufeinander folgende ganze Zahl für jeden aufeinander folgenden Parameter verwenden. Wenn die ID-Qualifizierer unbeabsichtigt weggelassen werden, generiert der MOF-Compiler automatisch ID-Qualifizierer .

Umgesetzt

Datentyp: Boolescher Wert

Gilt für: Methoden

Gibt an, dass eine Methode über eine Implementierung verfügt, die von einem Anbieter bereitgestellt wird.

InstanceContext

Datentyp: VT_BSTR

Gilt für: Instanzen

Gibt an, dass eine Instanz Werte enthält, die von einem dynamischen Eigenschaftenanbieter bereitgestellt werden.

Der Wert wird als Argument an die IWbemPropertyProvider::GetProperty-Methode an den Eigenschaftenanbieter übergeben.

Gebietsschema-

Datentyp: VT_BSTR

Gilt für: Klassen oder Instanzen

Gibt die Ursprungssprache für eine Klasse oder Instanz an. Weitere Informationen zu Gebietsschemawerten finden Sie unter Gebietsschemacodes.

NamespaceSecuritySDDL

Datentyp: Zeichenfolgenarray

Gilt für: Namespaceinstanzen

Gibt einen Sicherheitsdeskriptor für den Namespace im SDDL-Format an. Weitere Informationen finden Sie unter Festlegen der Namespacesicherheit beim Erstellen des Namespaces. Die SDDL-Zeichenfolge wird von WMI verarbeitet, um die Namespacesicherheit einzurichten, aber nicht als Zeichenfolge gespeichert. Wenn kein Sicherheitsdeskriptor angegeben ist, wird die Standardsicherheit verwendet. Weitere Informationen finden Sie unter Festlegen von Namespacesicherheitsdeskriptoren.

Wahlfrei

Datentyp: Boolescher Wert

Gilt für: Parameter

Gibt an, dass ein Parameter nicht erforderlich ist und dass er über einen gut verhaltenen Standardwert verfügt.

Privilegien

Datentyp: Zeichenfolgenarray

Gilt für: Eigenschaften, Methoden

Wertesatz, der verwendet wird, um den Client darüber zu informieren, welche Berechtigungen zum Erstellen von Instanzen, Ausfüllen von Eigenschaften oder Ausführen von Methoden erforderlich sind. Der Standardwert ist FALSE-.

PropertyContext

Datentyp: VT_BSTR

Gilt für: Eigenschaften

Gibt an, dass eine Instanzeigenschaft Werte enthält, die von dynamischen Eigenschaftenanbietern bereitgestellt werden.

Sie müssen diesen Qualifizierer für eine solche Eigenschaft angeben. Der Wert wird als Argument an den Eigenschaftenanbieter an IWbemPropertyProvider::GetProperty übergeben.

Provider-

Datentyp: VT_BSTR

Gilt für: Klassen

Der Wert dieses Qualifizierers ist der Name des dynamischen Anbieters, der Klasseninstanzen bereitstellt und Instanzdaten aktualisiert. Dieser Name muss bei WMI registriert werden, indem eine Instanz der __Win32Provider Klasse mit der Name-Eigenschaft erstellt wird, die diesen Namen enthält. Wenn dieser Qualifizierer für eine Klasse angegeben wird, deren Instanzen dynamisch bereitgestellt werden, muss auch der dynamische Qualifizierer angegeben werden.

RequiresEncryption

Datentyp: Boolescher Wert

Gilt für: Namespaceinstanzen

Bei Festlegung auf "TRUE" kennzeichnet "RequiresEncryption " einen Namespace, sodass Clientanwendungen und Skripts eine Verbindung mit verschlüsselter Authentifizierung herstellen müssen. Die Authentifizierungsebene muss auf RPC_C_AUTHN_LEVEL_PKT_PRIVACY in C++ festgelegt werden. In Skripting oder Visual Basic muss die Authentifizierungsebene auf WbemAuthenticationLevelPktPrivacy festgelegt werden. Weitere Informationen finden Sie unter Festlegen von Namespacesicherheitsdeskriptoren. Der Qualifizierer wird in MOF mit dem Pragma-Namespace-Präprozessorbefehl verwendet.

Weitere Informationen finden Sie unter Festlegen der Standardprozesssicherheitsebene mit C++ oder Festlegen der Standardprozesssicherheitsstufe mit VBScript. Skriptauthentifizierungsebenen werden in WbemAuthenticationLevelEnum definiert.

Singleton-

Datentyp: Boolescher Wert

Gilt für: Klassen

Legt eine Klasse fest, die nur eine Instanz aufweisen kann und die keine Schlüsseleigenschaften enthält.

Nur der Wert TRUE (Standard) ist zulässig.

Statisch

Datentyp: Boolescher Wert

Gilt für: Methoden

Gibt an, ob eine Methode mithilfe der Klassendefinition oder der zugehörigen Instanzen aufgerufen werden kann.

Die Methode kann nicht von einer Instanz aufgerufen werden.

Subtyp

Datentyp: VT_BSTR

Gilt für: Eigenschaften

Gibt an, dass eine Eigenschaft vom Typ CIM_DATETIME ein Zeitintervall anstelle einer bestimmten Uhrzeit darstellt.

Um die Eigenschaft als Intervall zu identifizieren, muss der Wert dieses Qualifizierers "interval" lauten. Alle anderen Werte für diesen Qualifizierer sind für die zukünftige Verwendung reserviert.

UUID

Datentyp: Zeichenfolge

Gilt für: Klassen

Universally unique identifier applied to the class.

ClassVersion

Datentyp: Zeichenfolge

Gilt für: Klassen

Die Versionsnummer des Klassenobjekts. Der Standardwert ist NULL. Die Versionsnummer wird erhöht, wenn Änderungen an der Klasse vorgenommen werden.

WritePrivileges

Datentyp: Zeichenfolgenarray

Gilt für: Eigenschaften

Wertesatz, der angibt, welche Systemberechtigungen verfügbar und für einen erfolgreichen Schreibvorgang aktiviert sein müssen.

Bemerkungen

Gebietsschemacodes

Ein Gebietsschemacode ist das Format "MS_<Three Digit Language ID>". Beispielsweise ist das englische Gebietsschema MS_409. In der folgenden Tabelle sind die Sprach-IDs aufgeführt.

Sprache Sprach-ID (hexadezimal)
Arabisch 401
Portugiesisch (Brasilien) 416
Chinesisch (vereinfacht) 804
Chinesisch (traditionell) 404
Tschechisch 405
Dänisch 406
Holländisch 413
Englisch (Standard) 409
Finnisch 40b
Französisch 40c
Deutsch 407
Griechisch 408
Hebräisch 40d
Ungarisch 40e
Italienisch 410
Japanisch 411
Koreanisch 412
Norwegisch 414
Polnisch 415
Portugiesisch (Portugal) 816
Russisch 419
Spanisch c0a
Schwedisch 41D
Türkisch 41f

Verwenden des Bypass_GetObject Qualifizierers

Die Verwendung des Bypass_GetObject Qualifizierers für eine Methode kann zu verwirrenden Ergebnissen führen.

Im folgenden Beispiel werden die Shape - und Circle-Klassen definiert. Beachten Sie, dass die Circle-Klasse von der Shape-Klasse abgeleitet wird.

class Shape
{
   string Name;
   uint32 DrawIt();  // - draws an irregular geometric shape
};

class Circle : Shape
{
   uint32 DrawIt();  // - draws a circle
};

Der folgende Aufruf von ExecMethod verwendet ein Circle-Objekt namens "MyCircle", um einen Kreis zu zeichnen.

ExecMethod("Shape.Name='MyCircle'","DrawIt");

Im vorherigen Szenario ruft WMI GetObject auf; ermittelt, dass "Shape.Name='MyCircle'" ein Kreis ist; und führt die Circle-Implementierung von DrawIt aus. Wenn Sie jedoch den Bypass_GetObject Qualifizierer für DrawIt verwenden, ruft WMI " GetObject" nicht auf, erkennt nicht, dass "Shape.Name='MyCircle'" ein Kreis ist, und führt die Shape-Implementierung von DrawIt anstelle der Circle-Implementierung von DrawIt aus.

Der folgende Aufruf von ExecMethod ruft immer die richtige Implementierung von DrawIt auf.

ExecMethod("Circle.Name='MyCircle'","DrawIt");

Anforderungen

Anforderung Wert
Mindest unterstützter Client
 Windows Vista
Unterstützter Server (Mindestversion)
 Windows Server 2008

Siehe auch

Festlegen von Namespacesicherheitsdeskriptoren

WMI-Qualifizierer

Hinzufügen eines Qualifizierers

  • Last updated on