De functie CreateClassEnumWmi

Retourneert een enumerator voor alle klassen die voldoen aan de opgegeven selectiecriteria.

Notitie

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

Syntaxis

HRESULT CreateClassEnumWmi (
   [in] BSTR                    strSuperclass,
   [in] long                    lFlags,
   [in] IWbemContext*           pCtx,
   [out] IEnumWbemClassObject** ppEnum,
   [in] DWORD                   authLevel,
   [in] DWORD                   impLevel,
   [in] IWbemServices*          pCurrentNamespace,
   [in] BSTR                    strUser,
   [in] BSTR                    strPassword,
   [in] BSTR                    strAuthority
);

Parameters

strSuperclass
[in] Als dit niet null of leeg is, geeft u de naam van een bovenliggende klasse op. De opsommingsfunctie retourneert alleen subklassen van deze klasse. Als deze leeg is null en lFlags is WBEM_FLAG_SHALLOW, retourneert alleen klassen op het hoogste niveau (klassen zonder bovenliggende klasse). Als deze leeg is null en lFlags is WBEM_FLAG_DEEP, worden alle klassen in de naamruimte geretourneerd.

lFlags
[in] Een combinatie van vlaggen die van invloed zijn op het gedrag van deze functie. De volgende waarden worden gedefinieerd in het headerbestand WbemCli.h , of u kunt ze definiëren als constanten in uw code:

Constant	Waarde	Beschrijving
WBEM_FLAG_USE_AMENDED_QUALIFIERS	0x20000	Indien ingesteld, haalt de functie de gewijzigde kwalificaties op die zijn opgeslagen in de gelokaliseerde naamruimte van de landinstelling van de huidige verbinding. Als dit niet is ingesteld, haalt de functie alleen de kwalificaties op die zijn opgeslagen in de directe naamruimte.
WBEM_FLAG_DEEP	0	De opsomming omvat alle subklassen in de hiërarchie, maar niet deze klasse.
WBEM_FLAG_SHALLOW	1	De opsomming bevat alleen zuivere exemplaren van deze klasse en sluit alle exemplaren van subklassen uit die eigenschappen leveren die niet in deze klasse zijn gevonden.
WBEM_FLAG_RETURN_IMMEDIATELY	0x10	De vlag veroorzaakt een semisynchrone aanroep.
WBEM_FLAG_FORWARD_ONLY	0x20	De functie retourneert een alleen-voorwaartse opsomming. Normaal gesproken zijn alleen-forward-enumerators sneller en gebruiken minder geheugen dan conventionele enumerators, maar ze staan geen aanroepen naar klonen toe.
WBEM_FLAG_BIDIRECTIONAL	0	WMI behoudt aanwijzers naar objecten in de opsomming totdat ze worden vrijgegeven.

De aanbevolen vlaggen zijn WBEM_FLAG_RETURN_IMMEDIATELY en WBEM_FLAG_FORWARD_ONLY voor de beste prestaties.

pCtx
[in] Deze waarde is nulldoorgaans . Anders is het een verwijzing naar een IWbemContext-exemplaar dat kan worden gebruikt door de provider die de aangevraagde klassen levert.

ppEnum
[uit] Hiermee ontvangt u de aanwijzer naar de enumerator.

authLevel
[in] Het autorisatieniveau.

impLevel
[in] Het imitatieniveau.

pCurrentNamespace
[in] Een aanwijzer naar een IWbemServices-object dat de huidige naamruimte vertegenwoordigt.

strUser
[in] De gebruikersnaam. Zie de functie ConnectServerWmi voor meer informatie.

strPassword
[in] Het wachtwoord. Zie de functie ConnectServerWmi voor meer informatie.

strAuthority
[in] De domeinnaam van de gebruiker. Zie de functie ConnectServerWmi voor meer informatie.

Retourwaarde

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

Constant	Waarde	Beschrijving
WBEM_E_ACCESS_DENIED	0x80041003	De gebruiker is niet gemachtigd om een of meer klassen weer te geven die door de functie kunnen worden geretourneerd.
WBEM_E_FAILED	0x80041001	Er is een niet-opgegeven fout opgetreden.
WBEM_E_INVALID_CLASS	0x80041010	strSuperClass bestaat niet.
WBEM_E_INVALID_PARAMETER	0x80041008	Een parameter is ongeldig.
WBEM_E_OUT_OF_MEMORY	0x80041006	Er is onvoldoende geheugen beschikbaar om de bewerking te voltooien.
WBEM_E_SHUTTING_DOWN	0x80041033	WMI is waarschijnlijk gestopt en opnieuw opgestart. Roep ConnectServerWmi opnieuw aan.
WBEM_E_TRANSPORT_FAILURE	0x80041015	De RPC-koppeling (Remote Procedure Call) tussen het huidige proces en WMI is mislukt.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Deze functie verpakt een aanroep naar de methode IWbemServices::CreateClassEnum .

Als de functie-aanroep mislukt, kunt u aanvullende foutinformatie verkrijgen door de functie GetErrorInfo aan te roepen.

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)