Udostępnij przez

Get, funkcja

Pobiera określoną wartość właściwości, jeśli istnieje.

Uwaga

Ten interfejs API jest przeznaczony tylko do użytku wewnętrznego. Nie jest przeznaczony do użycia z poziomu kodu dewelopera.

Składnia

HRESULT Get (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parametry

vFunc
[in] Ten parametr jest nieużywany.

ptr
[in] Wskaźnik do wystąpienia IWbemClassObject .

wszName
[in] Nazwa właściwości.

lFlags
[in] Zastrzeżone. Ten parametr musi mieć wartość 0.

pVal
[out] Jeśli funkcja zwróci wartość , zawiera wartość wszName właściwości . Argument pval ma przypisany prawidłowy typ i wartość kwalifikatora.

pvtType
[out] Jeśli funkcja zwróci wartość powodzenia, zawiera stałą TYPU MODELU CIM , która wskazuje typ właściwości. Jego wartość może być również wartością null.

plFlavor
[out] Jeśli funkcja zostanie zwrócona pomyślnie, otrzyma informacje o pochodzeniu właściwości. Jego wartością może być null, lub jedną z następujących WBEM_FLAVOR_TYPE stałych zdefiniowanych w pliku nagłówka WbemCli.h :

Stała Wartość Opis
WBEM_FLAVOR_ORIGIN_SYSTEM 0x40 Właściwość jest standardową właściwością systemową.
WBEM_FLAVOR_ORIGIN_PROPAGATED 0x20 Dla klasy: właściwość jest dziedziczona z klasy nadrzędnej.
Dla wystąpienia: właściwość dziedziczona z klasy nadrzędnej nie została zmodyfikowana przez wystąpienie.
WBEM_FLAVOR_ORIGIN_LOCAL 0 Dla klasy: właściwość należy do klasy pochodnej.
W przypadku wystąpienia: właściwość jest modyfikowana przez wystąpienie; oznacza to, że podano wartość lub dodano lub zmodyfikowano kwalifikator.

Wartość zwracana

Następujące wartości zwracane przez tę funkcję są definiowane w pliku nagłówkowym WbemCli.h lub można je zdefiniować jako stałe w kodzie:

Stała Wartość Opis
WBEM_E_FAILED 0x80041001 Wystąpiła ogólna awaria.
WBEM_E_INVALID_PARAMETER 0x80041008 Co najmniej jeden parametr jest nieprawidłowy.
WBEM_E_NOT_FOUND 0x80041002 Nie można odnaleźć określonej właściwości.
WBEM_E_OUT_OF_MEMORY 0x80041006 Za mało pamięci, aby ukończyć operację.
WBEM_S_NO_ERROR 0 Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

Ta funkcja opakowuje wywołanie metody IWbemClassObject::Get .

Funkcja Get może również zwracać właściwości systemowe.

Argument pVal ma przypisany prawidłowy typ i wartość dla kwalifikatora i funkcji COM VariantInit

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

wersje .NET Framework: dostępne od wersji 4.7.2

Zobacz też

  • Last updated on