IWbemQualifierSet::P ut-Methode (wbemcli.h)

Die IWbemQualifierSet::P ut-Methode schreibt den benannten Qualifizierer und wert. Der neue Qualifizierer überschreibt den vorherigen Wert desselben Namens. Wenn der Qualifizierer noch nicht vorhanden ist, wird er erstellt.

Manchmal ist es nicht möglich, den Wert eines Qualifizierers zu schreiben, z. B. wenn der Qualifizierer von einem anderen Objekt weitergegeben wird. In der Regel sind weitergegebene Qualifizierer schreibgeschützt, können aber überschrieben werden. Weitere Informationen finden Sie unter Qualifizierervarianten.

Bei Verwendung des Schlüsselqualifizierers müssen keine Varianten oder Weitergaberegeln angegeben werden.

Der Benutzer darf keine Qualifizierer mit Namen erstellen, die mit einem Unterstrich (_) beginnen oder enden. Dies ist für Systemklassen und -eigenschaften reserviert.

Syntax

HRESULT Put(
  [in] LPCWSTR wszName,
  [in] VARIANT *pVal,
  [in] long    lFlavor
);

Parameter

[in] wszName

Name des Qualifizierers, der geschrieben wird. Der Zeiger wird als schreibgeschützt behandelt.

[in] pVal

Darf nicht NULL sein. Dies muss auf einen gültigen VARIANT-Wert verweisen, der den zu schreibenden Qualifiziererwert enthält. Der Zeiger wird als schreibgeschützt behandelt. Es liegt in der Verantwortung des Aufrufers , VariantClear für diesen Zeiger aufzurufen, nachdem der Wert nicht erforderlich ist.

Es werden nur Varianten und Arrays vom Typ VT_I4, VT_R8, VT_BSTRVT_BOOL unterstützt.

[in] lFlavor

Gewünschte Qualifiziereraromen für diesen Qualifizierer. In der folgenden Liste sind die entsprechenden Konstanten für lFlavor aufgeführt. Der Standardwert ist 0 (null).

WBEM_FLAVOR_OVERRIDABLE (0 (0x0))

Der Qualifiziererwert kann in einer abgeleiteten Klasse oder einem instance überschrieben werden. Dies ist die Standardoption. Die Verwendung dieser Konstante entspricht der Verwendung des EnableOverride-Flags .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE (1 (0x1))

Der Qualifizierer wird an Instanzen weitergegeben. Die Verwendung dieser Konstante entspricht der Verwendung des ToInstance-Flags .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS (2 (0x2))

Der Qualifizierer wird an abgeleitete Klassen weitergegeben. Die Verwendung dieser Konstante entspricht der Verwendung des ToSubClass-Flags .

WBEM_FLAVOR_NOT_OVERRIDABLE (16 (0x10))

Der Qualifiziererwert kann nicht in einer abgeleiteten Klasse oder einem instance überschrieben werden. Die Verwendung dieser Konstante entspricht der Verwendung des DisableOverride-Flags .

WBEM_FLAVOR_AMENDED (128 (0x80))

Der Qualifizierer wird lokalisiert. Die Verwendung dieser Konstanten entspricht der Verwendung des Geänderten Flags.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Weitere Informationen

Qualifizierervarianten