GetPropertyQualifierSet, funkcja

Pobiera zestaw kwalifikatora dla określonej właściwości.

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 GetPropertyQualifierSet (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszProperty,
   [out] IWbemQualifierSet  **ppQualSet
);

Parametry

vFunc
[w] Ten parametr jest nieużywany.

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

wszMethod
[w] Nazwa właściwości. wszProperty musi wskazywać prawidłowy LPCWSTRelement .

ppQualSet
[out] Odbiera wskaźnik interfejsu, który umożliwia dostęp do kwalifikatorów właściwości. ppQualSet nie może być null. Jeśli wystąpi błąd, nowy obiekt nie jest zwracany, a wskaźnik jest ustawiony na nullwartość .

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_FAILED	0x80041001	Wystąpiła ogólna awaria.
WBEM_E_NOT_FOUND	0x80041002	Określona metoda nie istnieje.
WBEM_E_OUT_OF_MEMORY	0x80041006	Za mało pamięci jest dostępna do ukończenia operacji.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametr to null.
WBEM_E_SYSTEM_PROPERTY	0x80041030	Funkcja próbuje uzyskać kwalifikatory właściwości systemowej.
WBEM_S_NO_ERROR	0	Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

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

Wywołanie tej funkcji jest obsługiwane tylko wtedy, gdy bieżący obiekt jest definicją klasy CIM. Manipulowanie metodą nie jest dostępne dla wskaźników IWbemClassObject wskazujących wystąpienia modelu CIM.

Ponieważ każda metoda może mieć własne kwalifikatory, wskaźnik IWbemQualifierSet umożliwia wywołującemu dodawanie, edytowanie lub usuwanie tych kwalifikatorów.

Ponieważ właściwości systemu nie mają kwalifikatorów, funkcja zwraca wartość WBEM_E_SYSTEM_PROPERTY w przypadku próby uzyskania wskaźnika IWbemQualifierSet dla właściwości systemowej.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

.NET Framework wersje: dostępne od wersji 4.7.2

Zobacz też

• Liczniki wydajności i usługi WMI (dokumentacja niezarządzanych interfejsów API)