GetNames függvény

Egy objektum tulajdonságainak egy részhalmazát vagy összes nevét kéri le.

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 GetNames (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszQualifierName,
   [in] LONG                lFlags,
   [in] VARIANT*            pQualifierValue,
   [out] SAFEARRAY (BSTR)** pstrNames
);

Paraméterek

vFunc
[in] Ez a paraméter nincs használatban.

ptr
[in] Egy IWbemClassObject-példányra mutató mutató.

wszQualifierName
[in] Egy érvényes LPCWSTR mutató, amely egy szűrő részeként működő minősítőnevet határoz meg. További információkért lásd a Megjegyzések szakaszt . Ez a paraméter lehet null.

lFlags
[in] Bitmezők kombinációja. További információkért lásd a Megjegyzések szakaszt .

pQualifierValue [in] Egy szűrőértékbe inicializált érvényes VARIANT struktúra mutatója. Ez a paraméter lehet null.

pstrNames
[kifelé] Tulajdonságneveket SAFEARRAY tartalmazó struktúra. Bejegyzéskor ennek a paraméternek mindig a mutatónak kell lennie.null További információért tekintse meg a Megjegyzések szakaszt.

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_FAILED	0x80041001	Általános hiba történt.
WBEM_E_INVALID_PARAMETER	0x80041008	Egy vagy több paraméter érvénytelen, vagy a jelölők és paraméterek helytelen kombinációja lett megadva.
WBEM_E_OUT_OF_MEMORY	0x80041006	Nincs elegendő memória a művelet végrehajtásához.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.

Megjegyzések

Ez a függvény burkolja az IWbemClassObject::GetNames metódus hívását .

Az elnevezett visszaadott értékeket jelzők és paraméterek kombinációja vezérli. A függvény például visszaadhatja az összes tulajdonság nevét, vagy csak a kulcstulajdonságok nevét. Az elsődleges szűrő a lFlags paraméterben van megadva, a többi paraméter pedig attól függően változik.

A jelölőértékek bitmezők lFlags

Az argumentumként lEnumFlags átadható jelzők bitmezők, amelyek a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban. Az egyes csoportokból egy jelölőt kombinálhat bármely másik csoport bármelyik jelzőjével. Az ugyanabból a csoportból származó zászlók azonban kölcsönösen kizárják egymást.

1. csoportjelzők	Érték	Leírás
WBEM_FLAG_ALWAYS	0	Adja vissza az összes tulajdonságnevet. strQualifierName és pQualifierVal nincsenek használatban.
WBEM_FLAG_ONLY_IF_TRUE	1	Csak a paraméter által strQualifierName megadott névjelölővel rendelkező tulajdonságokat adja vissza. Ha ezt a jelzőt használja, meg kell adnia a értéket strQualifierName.
WBEM_FLAG_ONLY_IF_FALSE	2	Csak azokat a tulajdonságokat adja vissza, amelyek nem rendelkeznek a paraméter által strQualifierName megadott névjelölővel. Ha ezt a jelzőt használja, meg kell adnia a értéket strQualifierName.
WBEM_FLAG_ONLY_IF_IDENTICAL	3	Csak azokat a tulajdonságokat adja vissza, amelyek rendelkeznek a paraméter által wszQualifierName megadott névjelölővel, és amelyek értéke megegyezik a pQualifierVal struktúra által megadott értékkel. Ha ezt a jelzőt használja, meg kell adnia egy wszQualifierName és egy pQualifierValueértéket is.

2. csoportjelzők	Érték	Leírás
WBEM_FLAG_KEYS_ONLY	0x4	Csak a kulcsokat meghatározó tulajdonságok nevét adja vissza.
WBEM_FLAG_REFS_ONLY	0x8	Csak objektumhivatkozásokat tartalmazó tulajdonságneveket ad vissza.

3. csoportjelzők	Érték	Leírás
WBEM_FLAG_LOCAL_ONLY	0x10	Csak a leg származtatott osztályhoz tartozó tulajdonságneveket adja vissza. Tulajdonságok kizárása a szülőosztályokból.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Csak a szülőosztályokhoz tartozó tulajdonságneveket adja vissza.
WBEM_FLAG_SYSTEM_ONLY	0x30	Csak a rendszertulajdonságok nevét adja vissza.
WBEM_FLAG_NONSYSTEM_ONLY	0x40	Csak a nem rendszertulajdonságok nevét adja vissza.

A függvény mindig lefoglal egy újat SAFEARRAY , ha visszaadja WBEM_S_NO_ERRORa értéket, és pstrNames mindig úgy van beállítva, hogy rá mutasson. A visszaadott tömb 0 elemet tartalmazhat, ha nincs olyan tulajdonság, amely megfelel a megadott szűrőknek. Ha a függvény a függvényétől eltérő WBM_S_NO_ERRORértéket ad vissza, a függvény nem ad vissza új SAFEARRAY struktúrát.

Követelmények

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

Fejléc: WMINet_Utils.idl

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

Lásd még

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