Udostępnij przez

GetPropertyHandle, funkcja

Zwraca unikatowy uchwyt identyfikujący właściwość.

Uwaga

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

Składnia

HRESULT GetPropertyHandle (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] LPCWSTR              wszPropertyName,
   [out] CIMTYPE*            pType,
   [out] long*               pHandle
);

Parametry

vFunc
[w] Ten parametr jest nieużywany.

ptr
[w] Wskaźnik do wystąpienia IWbemObjectAccess .

wszPropertyName
[w] Ciąg zakończony o wartości null znaków zakodowanych w formacie UTF16, który zawiera nazwę właściwości.

pType
[out] Wskaźnik do CIMTYPE elementu członkowskiego wyliczenia, który reprezentuje typ CIM właściwości.

pHandle
[out] Wskaźnik do liczby całkowitej zawierającej uchwyt właściwości.

Wartość zwracana

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

Stała Wartość Opis
WBEM_E_NOT_FOUND 0x80041002 Nie można odnaleźć określonej nazwy właściwości.
WBEM_E_INVALID_PARAMETER 0x80041008 Parametr jest nieprawidłowy.
WBEM_E_NOT_SUPPORTED 0x8004100c Żądana właściwość ma typ CIM_OBJECT lub CIM_ARRAY.
WBEM_S_NO_ERROR 0 Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

Ta funkcja zawija wywołanie metody IWbemClassObject::GetPropertyHandle .

Tego uchwytu można użyć do identyfikowania właściwości podczas używania metod IWbemObjectAccess do odczytywania lub zapisywania wartości właściwości.

Uchwyty można pobrać dla właściwości wszystkich typów danych innych niż CIM_OBJECT i CIM_ARRAY. Zwrócone uchwyty działają we wszystkich wystąpieniach klasy.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

.NET Framework wersje: dostępne od wersji 4.7.2

Zobacz też

  • Last updated on