IWbemObjectAccess::GetPropertyHandle-Methode (wbemcli.h)

Die GetPropertyHandle-Methode gibt ein eindeutiges Handle zurück, das eine Eigenschaft identifiziert. Sie können diesen Handle verwenden, um Eigenschaften zu identifizieren, wenn IWbemObjectAccess-Methoden zum Lesen oder Schreiben von Eigenschaftswerten verwendet werden.

Syntax

HRESULT GetPropertyHandle(
  [in]  LPCWSTR wszPropertyName,
  [out] CIMTYPE *pType,
  [out] long    *plHandle
);

Parameter

[in] wszPropertyName

Konstante null-beendete Zeichenfolge mit 16-Bit-Unicode-Zeichen, die den Eigenschaftennamen enthält.

[out] pType

Zeiger auf einen CIMTYPE, der verwendet wird, um den CIM-Typ der Eigenschaft zurückzugeben.

[out] plHandle

Zeiger auf eine ganze Zahl, die verwendet wird, um das Eigenschaftenhandle zurückzugeben.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist.

Hinweise

Handles können für alle Datentypen außer CIM_OBJECT und CIM_ARRAY abgerufen werden. Zurückgegebene Handles funktionieren in allen Instanzen einer Klasse.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile wbemcli.h (include Wbemidl.h)
Bibliothek Wbemuuid.lib
DLL Esscli.dll; Fastprox.dll; Wbemess.dll

Weitere Informationen

IWbemObjectAccess