Get-Funktion

  • Artikel

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