QualifierSet_Delete-Funktion

  • Artikel

Löscht einen angegebenen Qualifizierer anhand des Namens.

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_Delete (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName
);

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

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

wszName [in] Der Name des zu löschenden Qualifizierers.

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_INVALID_PARAMETER 0x80041008 Der wszName-Parameter ist ungültig.
WBEM_E_INVALID_OPERATION 0x80041016 Das Löschen dieses Qualifizierers ist unzulässig.
WBEM_E_NOT_FOUND 0x80041002 Der angegebene Qualifizierer wurde nicht gefunden.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.
WBEM_S_RESET_TO_DEFAULT 0x40002 Die lokale Außerkraftsetzung wurde gelöscht, und der ursprüngliche Qualifizierer aus dem übergeordneten Objekt hat wieder den Gültigkeitsbereich übernommen.

Bemerkungen

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

Aufgrund von Regeln für die Weitergabe von Qualifizierern wurde möglicherweise ein bestimmter Qualifizierer von einem anderen Objekt geerbt und nur in der aktuellen Klasse oder Instanz außer Kraft gesetzt. In diesem Fall setzt die QualifierSet_Delete-Methode den Qualifizierer auf seinen ursprünglichen geerbten Wert zurück. Die Funktion gibt in diesem Fall den Statuscode WBEM_S_RESET_TO_DEFAULT zurück.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

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

Siehe auch