GetPropertyHandle-Funktion

  • Artikel

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

Siehe auch