Get-Funktion

Artikel
06/05/2023

Ruft den angegebenen Eigenschaftswert ab, wenn dieser vorhanden 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 Get (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Dies ist ein Zeiger auf eine IWbemClassObject-Instanz.

wszName
[in] Der Name der Eigenschaft.

lFlags
[in]: Reserviert Dieser Parameter muss 0 sein.

pVal
[out] Wenn die Funktion erfolgreich zurückgegeben wird, enthält den Wert der wszName-Eigenschaft. Dem pval-Argument wird der richtige Typ und Wert für den Qualifizierer zugewiesen.

pvtType
[out] Enthält bei erfolgreicher Rückgabe der Funktion eine CIM-Typkonstante, die den Eigenschaftstyp angibt. Dieser Wert kann auch null sein.

plFlavor
[out] Enthält bei erfolgreicher Rückgabe der Funktion Informationen über den Ursprung der Eigenschaft. Der zugehörige Wert kann null oder eine der folgenden WBEM_FLAVOR_TYPE-Konstanten sein, die in der Headerdatei WbemCli.h definiert sind:

Konstante	Wert	Beschreibung
`WBEM_FLAVOR_ORIGIN_SYSTEM`	0x40	Die Eigenschaft ist eine standardmäßige Systemeigenschaft.
`WBEM_FLAVOR_ORIGIN_PROPAGATED`	0x20	Für eine Klasse: Die Eigenschaft wird von der übergeordneten Klasse geerbt. Für eine Instanz: Die von der übergeordneten Klasse geerbte Eigenschaft wurde von der Instanz nicht geändert.
`WBEM_FLAVOR_ORIGIN_LOCAL`	0	Für eine Klasse: Die Eigenschaft gehört zur abgeleiteten Klasse. Für eine Instanz: Die Eigenschaft wurde von der Instanz geändert. Dies bedeutet, dass ein Wert angegeben oder ein Qualifizierer hinzugefügt oder geändert wurde.

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	Es ist ein allgemeiner Fehler aufgetreten.
`WBEM_E_INVALID_PARAMETER`	0x80041008	Mindestens ein Parameter ist ungültig.
`WBEM_E_NOT_FOUND`	0x80041002	Die angegebene Eigenschaft wurde nicht gefunden.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
`WBEM_S_NO_ERROR`	0	Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemClassObject::Get-Methode.

Die Get-Funktion kann auch Systemeigenschaften zurückgeben.

Dem pVal-Argument werden der richtige Typ und Wert für den Qualifizierer und die COM-Funktion VariantInit zugewiesen.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: Seit Version 4.7.2 verfügbar

Siehe auch

WMI und Leistungsindikatoren (Referenz zur nicht verwalteten API)

Freigeben über