Funkce GetPropertyHandle

Vrátí jedinečný popisovač, který identifikuje vlastnost.

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 GetPropertyHandle (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] LPCWSTR              wszPropertyName,
   [out] CIMTYPE*            pType,
   [out] long*               pHandle
);

Parametry

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

ptr
[v] Ukazatel na instanci IWbemObjectAccess .

wszPropertyName
[v] Řetězec ukončený hodnotou null znaků kódovaných UTF16, který obsahuje název vlastnosti.

pType
[out] Ukazatel na člen výčtu CIMTYPE , který představuje typ CIM vlastnosti.

pHandle
[out] Ukazatel na celé číslo, které obsahuje popisovač vlastnosti.

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_NOT_FOUND 0x80041002 Zadaný název vlastnosti nebyl nalezen.
WBEM_E_INVALID_PARAMETER 0x80041008 Parametr není platný.
WBEM_E_NOT_SUPPORTED 0x8004100c Požadovaná vlastnost je typu are CIM_OBJECT nebo CIM_ARRAY.
WBEM_S_NO_ERROR 0 Volání funkce bylo úspěšné.

Poznámky

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

Tento popisovač můžete použít k identifikaci vlastností při použití metod IWbemObjectAccess ke čtení nebo zápisu hodnot vlastností.

Popisovače je možné načíst pro vlastnosti všech datových typů kromě CIM_OBJECT a CIM_ARRAY. Vrácené popisovače fungují napříč všemi instancemi třídy.

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