QualifierSet_Put-Funktion

  • Artikel

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