QualifierSet_BeginEnumeration functie

Hiermee stelt u een enumerator van de kwalificaties van een object in op het begin van de opsomming.

Notitie

Deze API is alleen voor intern gebruik. Het is niet bedoeld voor gebruik vanuit ontwikkelaarscode.

Syntaxis

HRESULT QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

Parameters

vFunc
[in] Deze parameter wordt niet gebruikt.

ptr
[in] Een aanwijzer naar een exemplaar van IWbemQualifierSet .

lFlags
[in] Een bitsgewijze combinatie van de vlaggen of waarden die worden beschreven in de sectie Opmerkingen , waarin de kwalificaties worden opgegeven die in de opsomming moeten worden opgenomen.

Retourwaarde

De volgende waarden die door deze functie worden geretourneerd, worden gedefinieerd in het headerbestand WbemCli.h . U kunt ze ook definiëren als constanten in uw code:

Constant	Waarde	Beschrijving
WBEM_E_INVALID_PARAMETER	0x80041008	De lFlags parameter is ongeldig.
WBEM_E_UNEXPECTED	0x8004101d	Er is een tweede aanroep van QualifierSet_BeginEnumeration uitgevoerd zonder een tussenliggende aanroep van QualifierSet_EndEnumeration.
WBEM_E_OUT_OF_MEMORY	0x80041006	Er is onvoldoende geheugen beschikbaar om een nieuwe opsomming te starten.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Deze functie verpakt een aanroep van de methode IWbemQualifierSet::BeginEnumeration .

Als u alle kwalificaties voor een object wilt opsommen, moet deze methode worden aangeroepen vóór de eerste aanroep van QualifierSet_Next. De volgorde waarin kwalificaties worden opgesomd, is gegarandeerd invariant voor een bepaalde opsomming.

De vlaggen die als argument lEnumFlags kunnen worden doorgegeven, worden gedefinieerd in het headerbestand WbemCli.h . U kunt ze ook definiëren als constanten in uw code.

Constant	Waarde	Beschrijving
	0	Retourneer de namen van alle kwalificaties.
WBEM_FLAG_LOCAL_ONLY	0x10	Retourneer alleen de namen van kwalificaties die specifiek zijn voor de huidige eigenschap of het huidige object. Voor een eigenschap: retourneer alleen de kwalificaties die specifiek zijn voor de eigenschap (inclusief onderdrukkingen), en niet de kwalificaties die zijn doorgegeven vanuit de klassedefinitie. Voor een exemplaar: Retourneer alleen instantiespecifieke kwalificatienamen. Voor een klasse: retourneer alleen kwalificaties die specifiek zijn voor de klasse die wordt afgeleid.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Retourneert alleen de namen van kwalificaties die zijn doorgegeven vanuit een ander object. Voor een eigenschap: retourneert alleen de kwalificaties die zijn doorgegeven aan deze eigenschap uit de klassedefinitie en niet die van de eigenschap zelf. Voor een exemplaar: retourneer alleen de kwalificaties die zijn doorgegeven vanuit de klassedefinitie. Voor een klasse: retourneer alleen de kwalificatienamen die zijn overgenomen van de bovenliggende klassen.

Vereisten

Platforms: Zie Systeemvereisten.

Header: WMINet_Utils.idl

.NET Framework versies: beschikbaar sinds 4.7.2

Zie ook

• WMI en prestatiemeteritems (niet-beheerde API-verwijzing)