GetPropertyQualifierSet-Funktion
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
