CreateClassEnumWmi függvény

Egy enumerátort ad vissza az összes olyan osztályhoz, amely megfelel a megadott kiválasztási feltételeknek.

Megjegyzés

Ez az API csak belső használatra készült. Nem fejlesztői kódból való használatra készült.

Szintaxis

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
);

Paraméterek

strSuperclass
[in] Ha nem null vagy üres, a szülőosztály nevét adja meg; az enumerátor csak az osztály alosztályait adja vissza. Ha üres null vagy üres, és lFlags WBEM_FLAG_SHALLOW, csak legfelső szintű osztályokat ad vissza (szülőosztály nélküli osztályokat). Ha üres null vagy üres lFlagsWBEM_FLAG_DEEP, akkor a névtérben lévő összes osztályt adja vissza.

lFlags
[in] A függvény működését befolyásoló jelzők kombinációja. Az alábbi értékek a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban:

Állandó	Érték	Leírás
WBEM_FLAG_USE_AMENDED_QUALIFIERS	0x20000	Ha be van állítva, a függvény lekéri az aktuális kapcsolat területi beállításának honosított névterében tárolt módosított minősítőket. Ha nincs beállítva, a függvény csak a közvetlen névtérben tárolt minősítőket kéri le.
WBEM_FLAG_DEEP	0	Az enumerálás a hierarchia összes alosztályát tartalmazza, de ezt az osztályt nem.
WBEM_FLAG_SHALLOW	1	Az enumerálás csak az osztály tiszta példányait tartalmazza, és kizárja az összes olyan alosztálypéldányt, amely az ebben az osztályban nem található tulajdonságokat tartalmaz.
WBEM_FLAG_RETURN_IMMEDIATELY	0x10	A jelző félszinkron hívást okoz.
WBEM_FLAG_FORWARD_ONLY	0x20	A függvény egy csak előre megadott enumerátort ad vissza. A csak továbbítandó enumerátorok általában gyorsabbak, és kevesebb memóriát használnak, mint a hagyományos enumerátorok, de nem engedélyezik a klónozásra irányuló hívásokat.
WBEM_FLAG_BIDIRECTIONAL	0	A WMI mindaddig megőrzi az enumerálásban lévő objektumok mutatóit, amíg azok ki nem kerülnek.

Az ajánlott jelzők a WBEM_FLAG_RETURN_IMMEDIATELYWBEM_FLAG_FORWARD_ONLY és a legjobb teljesítmény érdekében.

pCtx
[in] Ez az érték általában a következő null: . Ellenkező esetben ez egy IWbemContext-példányra mutató mutató, amelyet a kért osztályokat biztosító szolgáltató használhat.

ppEnum
[kifelé] Fogadja az enumerátorra mutató mutatót.

authLevel
[in] Az engedélyezési szint.

impLevel
[in] A megszemélyesítési szint.

pCurrentNamespace
[in] Az aktuális névteret jelképező IWbemServices-objektumra mutató mutató.

strUser
[in] A felhasználónév. További információt a ConnectServerWmi függvényben talál.

strPassword
[in] A jelszó. További információt a ConnectServerWmi függvényben talál.

strAuthority
[in] A felhasználó tartományneve. További információt a ConnectServerWmi függvényben talál.

Visszatérési érték

A függvény által visszaadott alábbi értékek a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban:

Állandó	Érték	Leírás
WBEM_E_ACCESS_DENIED	0x80041003	A felhasználónak nincs engedélye a függvény által visszaadható osztályok megtekintésére.
WBEM_E_FAILED	0x80041001	Nem meghatározott hiba történt.
WBEM_E_INVALID_CLASS	0x80041010	strSuperClass nem létezik.
WBEM_E_INVALID_PARAMETER	0x80041008	A paraméter érvénytelen.
WBEM_E_OUT_OF_MEMORY	0x80041006	Nincs elég memória a művelet végrehajtásához.
WBEM_E_SHUTTING_DOWN	0x80041033	A WMI valószínűleg leállt, és újraindult. Hívja újra a ConnectServerWmi parancsot.
WBEM_E_TRANSPORT_FAILURE	0x80041015	A távoli eljáráshívás (RPC) kapcsolata az aktuális folyamat és a WMI között meghiúsult.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.

Megjegyzések

Ez a függvény körbefuttat egy hívást az IWbemServices::CreateClassEnum metódushoz.

Ha a függvényhívás sikertelen, további hibainformációkhoz juthat a GetErrorInfo függvény meghívásával.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: WMINet_Utils.idl

.NET-keretrendszer verziók: 4.7.2-től érhető el

Lásd még

• WMI- és teljesítményszámlálók (nem felügyelt API-referencia)