Funkce GetNames

Načte buď podmnožinu, nebo všechny názvy vlastností objektu.

Poznámka

Toto rozhraní API je určené pouze pro interní použití. Není určen pro použití z kódu vývojáře.

Syntaxe

HRESULT GetNames (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszQualifierName,
   [in] LONG                lFlags,
   [in] VARIANT*            pQualifierValue,
   [out] SAFEARRAY (BSTR)** pstrNames
);

Parametry

vFunc
[v] Tento parametr se nepoužívá.

ptr
[v] Ukazatel na instanci IWbemClassObject .

wszQualifierName
[v] Ukazatel na platný LPCWSTR , který určuje název kvalifikátoru, který funguje jako součást filtru. Další informace najdete v části Poznámky . Tento parametr může být null.

lFlags
[v] Kombinace bitových polí Další informace najdete v části Poznámky .

pQualifierValue [v] Ukazatel na platnou VARIANT strukturu inicializovanou na hodnotu filtru. Tento parametr může být null.

pstrNames
[out] Struktura SAFEARRAY , která obsahuje názvy vlastností. Při zadání musí být tento parametr vždy ukazatelem na null. Další informace najdete v části Poznámky .

Vrácená hodnota

Následující hodnoty vrácené touto funkcí jsou definovány v hlavičce souboru WbemCli.h nebo je můžete definovat jako konstanty v kódu:

Konstanta Hodnota Popis
WBEM_E_FAILED 0x80041001 Došlo k obecné chybě.
WBEM_E_INVALID_PARAMETER 0x80041008 Jeden nebo více parametrů není platný nebo byla zadána nesprávná kombinace příznaků a parametrů.
WBEM_E_OUT_OF_MEMORY 0x80041006 K dokončení operace není k dispozici dostatek paměti.
WBEM_S_NO_ERROR 0 Volání funkce bylo úspěšné.

Poznámky

Tato funkce zabalí volání metody IWbemClassObject::GetNames .

Vrácené názvy jsou řízeny kombinací příznaků a parametrů. Funkce může například vracet názvy všech vlastností nebo jenom názvy vlastností klíče. Primární filtr je zadán v parametru lFlags a ostatní parametry se liší v závislosti na něm.

Hodnoty příznaku v lFlags nástroji jsou bitová pole.

Příznaky, které lze předat jako lEnumFlags argument, jsou bitová pole, která jsou definována v souboru hlaviček WbemCli.h , nebo je můžete definovat jako konstanty v kódu. Můžete zkombinovat jeden příznak z každé skupiny s libovolným příznakem z jakékoli jiné skupiny. Příznaky ze stejné skupiny se však vzájemně vylučují.

Příznaky skupiny 1 Hodnota Popis
WBEM_FLAG_ALWAYS 0 Vrátí všechny názvy vlastností. strQualifierName a pQualifierVal nepoužívané.
WBEM_FLAG_ONLY_IF_TRUE 1 Vrátí pouze vlastnosti, které mají kvalifikátor názvu určeného parametrem strQualifierName . Pokud se použije tento příznak, musíte zadat strQualifierName.
WBEM_FLAG_ONLY_IF_FALSE 2 Vrátí pouze vlastnosti, které nemají kvalifikátor názvu určeného parametrem strQualifierName . Pokud se použije tento příznak, musíte zadat strQualifierName.
WBEM_FLAG_ONLY_IF_IDENTICAL 3 Vrátí pouze vlastnosti, které mají kvalifikátor názvu určeného wszQualifierName parametrem a mají také hodnotu shodnou s hodnotou určenou strukturou pQualifierVal . Pokud se používá tento příznak, musíte zadat a wszQualifierName a pQualifierValue.
Příznaky skupiny 2 Hodnota Popis
WBEM_FLAG_KEYS_ONLY 0x4 Vrátí pouze názvy vlastností, které definují klíče.
WBEM_FLAG_REFS_ONLY 0x8 Vrátí pouze názvy vlastností, které jsou odkazy na objekty.
Příznaky skupiny 3 Hodnota Popis
WBEM_FLAG_LOCAL_ONLY 0x10 Vrátit pouze názvy vlastností, které patří do nejvíce odvozené třídy. Vyloučit vlastnosti z nadřazených tříd.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Vrátí pouze názvy vlastností, které patří do nadřazených tříd.
WBEM_FLAG_SYSTEM_ONLY 0x30 Vrátit pouze názvy systémových vlastností.
WBEM_FLAG_NONSYSTEM_ONLY 0x40 Vrátí pouze názvy nesystémových vlastností.

Funkce vždy přidělí nový SAFEARRAY , pokud vrátí WBEM_S_NO_ERRORhodnotu , a pstrNames je vždy nastavená tak, aby na ni ukazovala. Vrácené pole může mít 0 elementů, pokud žádné vlastnosti neodpovídají zadaným filtrům. Pokud funkce vrátí jinou hodnotu než WBM_S_NO_ERROR, nová SAFEARRAY struktura se nevrátí.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: WMINet_Utils.idl

Verze rozhraní .NET Framework: K dispozici od verze 4.7.2

Viz také

  • Last updated on