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 |