GetPropertyQualifierSet-Funktion

  • Artikel

Ruft den Qualifizierer ab, der für eine bestimmte Eigenschaft festgelegt ist.

Hinweis

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

Syntax

HRESULT GetPropertyQualifierSet (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszProperty,
   [out] IWbemQualifierSet  **ppQualSet
);

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Ein Zeiger auf eine IWbemClassObject-Instanz

wszMethod
[in] Der Name der Eigenschaft. wszProperty muss auf einen gültigen LPCWSTR verweisen.

ppQualSet
[out] Empfängt den Schnittstellenzeiger, der den Zugriff auf die Qualifizierer der Eigenschaft ermöglicht. ppQualSet darf nicht null sein. Wenn ein Fehler auftritt, wird kein neues Objekt zurückgegeben, und der Zeiger verweist auf null.

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_FAILED 0x80041001 Ein allgemeiner Fehler ist aufgetreten.
WBEM_E_NOT_FOUND 0x80041002 Die angegebene Methode ist nicht vorhanden.
WBEM_E_OUT_OF_MEMORY 0x80041006 Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
WBEM_E_INVALID_PARAMETER 0x80041008 Ein Parameter ist null.
WBEM_E_SYSTEM_PROPERTY 0x80041030 Die Funktion versucht, Qualifizierer einer Systemeigenschaft abzurufen.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemClassObject::GetPropertyQualifierSet-Methode.

Ein Aufruf dieser Funktion wird nur unterstützt, wenn das aktuelle Objekt eine CIM-Klassendefinition ist. Die Methodenbearbeitung ist für IWbemClassObject-Zeiger, die auf CIM-Instanzen verweisen, nicht möglich.

Da jede Methode über eigene Qualifizierer verfügen kann, kann der Aufrufer mit dem IWbemQualifierSet-Zeiger diese Qualifizierer hinzufügen, bearbeiten oder löschen.

Da Systemeigenschaften über keine Qualifizierer verfügen, gibt die Funktion WBEM_E_SYSTEM_PROPERTY zurück, wenn Sie versuchen, einen IWbemQualifierSet-Zeiger für eine Systemeigenschaft abzurufen.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

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

Siehe auch