IWbemQualifierSet::GetNames-Methode (wbemcli.h)

Artikel
08/27/2023

Die IWbemQualifierSet::GetNames-Methode ruft die Namen aller Qualifizierer ab, die aus dem aktuellen Objekt oder der aktuellen Eigenschaft verfügbar sind. Alternativ ruft diese Methode abhängig vom Filterwert von IFlags die Namen bestimmter Qualifizierer ab.

Sie können mithilfe von IWbemQualifierSet::Get für jeden Namen auf diese Qualifizierer zugreifen. Es ist kein Fehler, dass ein bestimmtes Objekt über null Qualifizierer verfügt, sodass die Anzahl der Zeichenfolgen in pstrNames bei der Rückgabe 0 sein kann, obwohl WBEM_S_NO_ERROR zurückgibt.

Syntax

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

Parameter

[in] lFlags

Eine der folgenden Konstanten.

0 (Null)

Die Namen aller Qualifizierer zurückgeben.

WBEM_FLAG_LOCAL_ONLY

Nur die Namen von Qualifizierern zurückgeben, die für die aktuelle Eigenschaft oder das aktuelle Objekt spezifisch sind. Wenn sich der aktuelle Qualifizierersatz auf eine Eigenschaft bezieht, geben Sie nur die für die Eigenschaft spezifischen Qualifizierer (einschließlich Außerkraftsetzungen) zurück, nicht die Qualifizierer, die von der Klassendefinition weitergegeben werden. Wenn der aktuelle Qualifizierersatz auf einen instance verweist, geben Sie nur instance spezifischen Qualifizierernamen zurück. Wenn der aktuelle Qualifizierersatz auf eine Klasse verweist, geben Sie nur Qualifizierer zurück, die für die abgeleitete Klasse spezifisch sind.

WBEM_FLAG_PROPAGATED_ONLY

Nur die Namen der Qualifizierer zurückgeben, die aus einem anderen Objekt weitergegeben werden. Wenn sich der aktuelle Qualifizierersatz beispielsweise auf eine Eigenschaft bezieht, geben Sie nur die Qualifizierer zurück, die aus der Klassendefinition an diese Eigenschaft weitergegeben wurden, und nicht die aus der Eigenschaft selbst. Wenn der aktuelle Qualifizierersatz auf einen instance verweist, geben Sie nur die Qualifizierer zurück, die aus der Klassendefinition weitergegeben werden. Wenn der aktuelle Qualifizierersatz auf eine Klasse verweist, geben Sie nur die Von den übergeordneten Klassen geerbten Qualifizierernamen zurück.

[out] pNames

Es wird ein neues SAFEARRAY erstellt, das die angeforderten Namen enthält.

In allen Fällen, in denen kein Fehler zurückgegeben wird, wird ein neues Array erstellt, und pstrNames wird so festgelegt, dass darauf verweist. Dies tritt auch auf, wenn das resultierende Array über null Elemente verfügt. Bei Einem Fehler wird kein neues SAFEARRAY zurückgegeben.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.

Hinweise

Ein Beispiel für die Verwendung von SAFEARRAYsvon BSTR-Instanzenfinden Sie unter Abrufen eines Teils einer WMI-Instanz.

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	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll