IWbemClassObject::GetNames-Methode (wbemcli.h)

Die IWbemClassObject::GetNames-Methode ruft die Namen der Eigenschaften im -Objekt ab. Darüber hinaus kann es je nach vom Benutzer bereitgestellten Auswahlkriterien alle oder eine Teilmenge der Eigenschaften abrufen. Auf diese Eigenschaften kann dann mit IWbemClassObject::Get für jeden Namen zugegriffen werden. Diese Methode kann auch Systemeigenschaften zurückgeben.

Syntax

HRESULT GetNames(
  [in]  LPCWSTR   wszQualifierName,
  [in]  long      lFlags,
  [in]  VARIANT   *pQualifierVal,
  [out] SAFEARRAY **pNames
);

Parameter

[in] wszQualifierName

Ein Parameter, der NULL sein kann. Wenn nicht NULL, muss er auf einen gültigen LPCWSTR verweisen, der einen Qualifizierernamen angibt, der als Teil eines Filters ausgeführt wird. Dies wird als schreibgeschützt behandelt. Weitere Informationen finden Sie in den Hinweisen.

[in] lFlags

Weitere Informationen finden Sie in den Hinweisen.

[in] pQualifierVal

Ein Parameter, der NULL sein kann. Wenn nicht NULL, muss sie auf eine gültige VARIANT-Struktur verweisen, die auf einen Filterwert initialisiert ist. Dieser VARIANT-Wert wird von der -Methode als schreibgeschützt behandelt. Daher muss der Aufrufer bei Bedarf VariantClear darauf aufrufen. Weitere Informationen finden Sie in den Hinweisen.

[out] pNames

Ein Parameter, der nicht NULL sein darf, aber beim Eintrag muss dieser Parameter auf NULL zeigen. Eine neue SAFEARRAY-Struktur wird immer zugeordnet, und der Zeiger ist auf sie festgelegt. Das zurückgegebene Array kann 0 Elemente enthalten, wird aber immer zugeordnet, wenn WBEM_S_NO_ERROR zurückgibt. Bei Einem Fehler wird keine neue SAFEARRAY-Struktur zurückgegeben.

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. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Hinweise

Die zurückgegebenen Namen werden durch eine Kombination aus Flags und Parametern gesteuert. Beispielsweise können alle Namen aller Eigenschaften angegeben werden, oder es können nur die Schlüsseleigenschaften angegeben werden usw. Der primäre Filter wird im lFlags-Parameter angegeben. die anderen Parameter variieren je nachdem.

Die Flagwerte sind Bitfelder und können kombiniert werden. Ein Flag aus jeder der folgenden Gruppen kann mit einem Flag aus jeder der anderen Gruppen kombiniert werden. Flagwerte innerhalb einer Gruppe schließen sich gegenseitig aus.

Flags der Gruppe 1	BESCHREIBUNG
WBEM_FLAG_ALWAYS	Gibt alle Eigenschaftennamen zurück. Die Parameter strQualifierName und pQualifierVal werden nicht verwendet.
WBEM_FLAG_ONLY_IF_TRUE	Gibt nur Eigenschaften zurück, die über einen Qualifizierer des durch den Parameter strQualifierName angegebenen Namens verfügen. Wenn dieses Flag verwendet wird, müssen Sie strQualifierName angeben.
WBEM_FLAG_ONLY_IF_FALSE	Gibt nur Eigenschaften zurück, die nicht über einen Qualifizierer des durch den Parameter strQualifierName angegebenen Namens verfügen. Wenn dieses Flag verwendet wird, müssen Sie strQualifierName angeben.
WBEM_FLAG_ONLY_IF_IDENTICAL	Gibt nur Eigenschaften zurück, die über einen Qualifizierer des durch den Parameter QualifierName angegebenen Namens verfügen, und außerdem einen Wert haben, der mit dem Wert identisch ist, der von der VARIANT-Struktur angegeben ist, auf die von pQualifierVal verwiesen wird. Wenn dieses Flag verwendet wird, müssen Sie sowohl QualifierName als auch pQualifierVal angeben.

 

Flags der Gruppe 2	BESCHREIBUNG
WBEM_FLAG_KEYS_ONLY	Gibt nur die Namen der Eigenschaft oder eigenschaften zurück, die die Schlüssel definieren.
WBEM_FLAG_REFS_ONLY	Gibt nur Eigenschaftsnamen zurück, bei denen es sich um Objektverweise handelt.

 

Flags der Gruppe 3	BESCHREIBUNG
WBEM_FLAG_LOCAL_ONLY	Gibt nur Eigenschaftsnamen zurück, die zur am meisten abgeleiteten Klasse gehören. Schließen Sie Eigenschaften aus der übergeordneten Klasse oder übergeordneten Klassen aus.
WBEM_FLAG_PROPAGATED_ONLY	Gibt nur Eigenschaftennamen zurück, die zur übergeordneten Oder übergeordneten Klasse gehören.
WBEM_FLAG_SYSTEM_ONLY	Gibt nur Systemeigenschaften zurück.
WBEM_FLAG_NONSYSTEM_ONLY	Gibt nur Eigenschaftsnamen zurück, die keine Systemeigenschaften sind.

 

Es ist kein Fehler, dass eine leere Liste zurückgegeben wird, wenn keine Eigenschaften mit den angegebenen Filtern übereinstimmen.

Weitere Informationen zur Verwendung von SAFEARRAY-Strukturen von BSTR-Werten finden Sie unter Abrufen eines Teils einer WMI-Instanz.

Anforderungen

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	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Weitere Informationen

IWbemClassObject

IWbemClassObject::BeginEnumeration

IWbemClassObject::Get

WBEM_CONDITION_FLAG_TYPE

WMI-Systemeigenschaften