QualifierSet_GetNames-Funktion

Artikel
06/02/2023

Ruft die Namen aller Qualifizierer oder bestimmter Qualifizierer ab, die aus dem aktuellen Objekt oder der aktuellen Eigenschaft verfügbar sind.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

HRESULT QualifierSet_GetNames (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] SAFEARRAY (BSTR)**  pstrNames
);

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Ein Zeiger auf eine IWbemQualifierSet-Instanz.

lFlags
[in] Eins der folgenden Flags oder der folgenden Werte, das/der angibt, welche Namen in die Enumeration aufgenommen werden sollen.

Konstante	Wert	BESCHREIBUNG
	0	Die Namen aller Qualifizierer zurückgeben.
`WBEM_FLAG_LOCAL_ONLY`	0x10	Nur die Namen von Qualifizierern zurückgeben, die für die aktuelle Eigenschaft oder das aktuelle Objekt spezifisch sind. Für eine Eigenschaft: Nur die Qualifizierer zurückgeben, die für die Eigenschaft spezifisch sind (einschließlich Überschreibungen), und nicht die Qualifizierer, die aus der Klassendefinition weitergegeben werden. Für eine Instanz: Nur instanzspezifische Qualifizierernamen zurückgeben. Für eine Klasse: Nur Qualifizierer zurückgeben, die für die Klasse spezifisch sind, die abgeleitet wird.
`WBEM_FLAG_PROPAGATED_ONLY`	0x20	Nur die Namen der Qualifizierer zurückgeben, die aus einem anderen Objekt weitergegeben werden. Für eine Eigenschaft: Nur die Qualifizierer zurückgeben, die aus der Klassendefinition an diese Eigenschaft weitergegeben werden, und nicht die Qualifizierer aus der Eigenschaft selbst. Für eine Instanz: Nur die Qualifizierer zurückgeben, die aus der Klassendefinition weitergegeben werden. Für eine Klasse: Nur die von den übergeordneten Klassen geerbten Qualifizierernamen zurückgeben.

pstrNames
[out] Ein neues SAFEARRAY, das die angeforderten Namen enthält. Das Array kann 0 Elemente enthalten. Wenn ein Fehler auftritt, wird kein neues SAFEARRAY zurückgegeben.

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_INVALID_PARAMETER`	0x80041008	Ein Parameter ist nicht gültig.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Es ist nicht genügend Arbeitsspeicher verfügbar, um eine neue Enumeration zu starten.
`WBEM_S_NO_ERROR`	0	Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemQualifierSet::GetNames-Methode.

Nachdem Sie die Qualifizierernamen abgerufen haben, können Sie auf jeden Qualifizierer anhand des Namens zugreifen, indem Sie die QualifierSet_Get-Funktion aufrufen.

Es stellt keinen Fehler dar, wenn ein angegebenes Objekt über keine (Null) Qualifizierer verfügt, sodass die Anzahl der Zeichenfolgen in pstrNames bei Rückgabe 0 sein kann, obwohl die Funktion WBEM_S_NO_ERROR zurückgibt.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

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

Weitere Informationen

WMI und Leistungsindikatoren (Referenz zur nicht verwalteten API)

Freigeben über