QualifierSet_GetNames, funkcja

Pobiera nazwy wszystkich kwalifikatorów lub niektórych kwalifikatorów, które są dostępne z bieżącego obiektu lub 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 QualifierSet_GetNames (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] SAFEARRAY (BSTR)**  pstrNames
);

Parametry

vFunc
[w] Ten parametr jest nieużywany.

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

lFlags
[w] Jedna z następujących flag lub wartości określających nazwy do uwzględnienia w wyliczenie.

Stała	Wartość	Opis
	0	Zwróć nazwy wszystkich kwalifikatorów.
WBEM_FLAG_LOCAL_ONLY	0x10	Zwracaj tylko nazwy kwalifikatorów specyficznych dla bieżącej właściwości lub obiektu. Dla właściwości: Zwróć tylko kwalifikatory specyficzne dla właściwości (w tym przesłonięcia), a nie te kwalifikatory propagowane z definicji klasy. W przypadku wystąpienia: Zwracaj tylko nazwy kwalifikatora specyficzne dla wystąpienia. Dla klasy: Zwracaj tylko kwalifikatory specyficzne dla klasy pochodnej.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Zwróć tylko nazwy kwalifikatorów propagowanych z innego obiektu. Dla właściwości: Zwróć tylko kwalifikatory propagowane do tej właściwości z definicji klasy, a nie te z samej właściwości. Dla wystąpienia: zwróć tylko te kwalifikatory propagowane z definicji klasy. Dla klasy: Zwróć tylko te nazwy kwalifikatora dziedziczone z klas nadrzędnych.

pstrNames
[out] Nowa SAFEARRAY , która zawiera żądane nazwy. Tablica może zawierać 0 elementów. Jeśli wystąpi błąd, nowy SAFEARRAY nie zostanie zwrócony.

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_INVALID_PARAMETER	0x80041008	Parametr jest nieprawidłowy.
WBEM_E_OUT_OF_MEMORY	0x80041006	Za mało pamięci, aby rozpocząć nową wyliczenie.
WBEM_S_NO_ERROR	0	Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

Ta funkcja opakowuje wywołanie metody IWbemQualifierSet::GetNames .

Po pobraniu nazw kwalifikatora można uzyskać dostęp do każdego kwalifikatora według nazwy, wywołując funkcję QualifierSet_Get .

Nie jest to błąd dla danego obiektu, który ma zero kwalifikatorów, więc liczba ciągów w pstrNames zwracaniu może wynosić 0, mimo że funkcja zwraca WBEM_S_NO_ERRORwartość .

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)