Freigeben über

QualifierSet_Put-Funktion

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

Hinweis

Diese API ist nur für die interne Verwendung vorgesehen. Es ist nicht für die Verwendung aus Entwicklercode vorgesehen.

Syntax

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

Die 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 kann nicht sein null.

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

Dauerhaft Wert Description
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 Headerdatei WbemCli.h definiert, oder Sie können sie als Konstanten in Ihrem Code definieren:

Dauerhaft Wert Description
WBEM_E_CANNOT_BE_KEY 0x8004101f Es gab einen unzulässigen Versuch, den Key Qualifizierer für eine Eigenschaft anzugeben, die kein Schlüssel sein kann. Die Schlüssel werden in der Klassendefinition für ein Objekt angegeben und können nicht pro Instanz geändert werden.
WBEM_E_INVALID_PARAMETER 0x80041008 Ein Parameter ist ungültig.
WBEM_E_INVALID_QUALIFIER_TYPE 0x80041029 Der pVal Parameter weist keinen rechtlichen Qualifizierertyp auf.
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 Außerkraftsetzungen zulässt.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.

Bemerkungen

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

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Kopfball: WMINet_Utils.idl

.NET Framework-Versionen: Verfügbar seit 4.7.2

Siehe auch

  • Last updated on