QualifierSet_Put-Funktion

Artikel
06/02/2023

Schreibt den benannten Qualifizierer und den Wert. Der neue Qualifizierer überschreibt den vorherigen Wert desselben Namens. Wenn der Qualifizierer noch nicht vorhanden ist, wird er erstellt.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

HRESULT QualifierSet_Put (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName,
   [in] VARIANT*             pVal,
   [in] LONG                 lFlavor
);

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Ein Zeiger auf eine IWbemQualifierSet-Instanz.

wszName
[in] Der Name des zu schreibenden Qualifizierers.

pVal
[in] Ein Zeiger auf einen gültigen VARIANT-Wert, der den zu schreibenden Qualifizierer enthält. Dieser Parameter darf nicht null sein.

lFlavor
[in] Eine der folgenden Konstanten, die die gewünschten Qualifiziertypen für diesen Qualifizierer definiert. Der Standardwert ist WBEM_FLAVOR_OVERRIDABLE (0).

Konstante	Wert	BESCHREIBUNG
`WBEM_FLAVOR_OVERRIDABLE`	0	Der Qualifizierer kann in einer abgeleiteten Klasse oder Instanz überschrieben werden. Dies ist der Standardwert.
`WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE`	1	Der Qualifizierer wird an Instanzen weitergegeben.
`WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS`	2	Der Qualifizierer wird an abgeleitete Klassen weitergegeben.
`WBEM_FLAVOR_NOT_OVERRIDABLE`	0x10	Der Qualifizierer kann in einer abgeleiteten Klasse oder Instanz nicht überschrieben werden.
`WBEM_FLAVOR_AMENDED`	0x80	Der Qualifizierer wird lokalisiert.

Rückgabewert

Die folgenden von dieser Funktion zurückgegebenen Werte werden in der WbemCli.h-Headerdatei definiert, oder Sie können sie als Konstanten im Code definieren:

Konstante	Wert	BESCHREIBUNG
`WBEM_E_CANNOT_BE_KEY`	0x8004101f	Es wurde ein unzulässiger Versuch unternommen, einen Key-Qualifizierer für eine Eigenschaft anzugeben, die kein Schlüssel sein kann. Die Schlüssel sind in der Klassendefinition für ein Objekt angegeben und können nicht für jede Instanz einzeln geändert werden.
`WBEM_E_INVALID_PARAMETER`	0x80041008	Ein Parameter ist nicht gültig.
`WBEM_E_INVALID_QUALIFIER_TYPE`	0x80041029	Der `pVal`-Parameter hat keinen zulässigen Qualifizierertyp.
`WBEM_E_OVERRIDE_NOT_ALLOWED`	0x8004101a	Es ist nicht möglich, die `QualifierSet_Put`-Methode für den Qualifizierer aufzurufen, da das besitzende Objekt keine Überschreibungen zulässt.
`WBEM_S_NO_ERROR`	0	Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemQualifierSet::Put-Methode.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: Seit Version 4.7.2 verfügbar

Weitere Informationen

WMI und Leistungsindikatoren (Referenz zur nicht verwalteten API)

Freigeben über