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 |