GetPropertyHandle-Funktion
Gibt ein eindeutiges Handle zurück, das eine Eigenschaft identifiziert.
Hinweis
Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.
Syntax
HRESULT GetPropertyHandle (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] LPCWSTR wszPropertyName,
[out] CIMTYPE* pType,
[out] long* pHandle
);
Parameter
vFunc
[in] Dieser Parameter wird nicht verwendet.
ptr
[in] Ein Zeiger auf eine IWbemObjectAccess-Instanz.
wszPropertyName
[in] Eine NULL-Zeichenfolge mit UTF16-codierten Zeichen, die den Eigenschaftennamen enthält.
pType
[out] Ein Zeiger auf einen CIMTYPE-Enumerationsmember, der den CIM-Typ der Eigenschaft darstellt.
pHandle
[out] Ein Zeiger auf einen Integer, der den Eigenschaftenhandle enthält.
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_NOT_FOUND |
0x80041002 | Der angegebene Eigenschaftenname wurde nicht gefunden. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | Ein Parameter ist nicht gültig. |
WBEM_E_NOT_SUPPORTED |
0x8004100c | Die angeforderte Eigenschaft ist vom Typ CIM_OBJECT oder CIM_ARRAY. |
WBEM_S_NO_ERROR |
0 | Der Funktionsaufruf war erfolgreich. |
Bemerkungen
Diese Funktion umschließt einen Aufruf der IWbemClassObject::GetPropertyHandle-Methode.
Sie können diesen Handle verwenden, um Eigenschaften zu identifizieren, wenn IWbemObjectAccess-Methoden zum Lesen oder Schreiben von Eigenschaftswerten verwendet werden.
Handles können für Eigenschaften aller anderen Datentypen als CIM_OBJECT und CIM_ARRAY abgerufen werden. Zurückgegebene Handles funktionieren in allen Instanzen einer Klasse.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: WMINet_Utils.idl
.NET Framework-Versionen: Seit Version 4.7.2 verfügbar
