Udostępnij przez

GetNames, funkcja

Pobiera podzestaw lub wszystkie nazwy właściwości obiektu.

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 GetNames (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszQualifierName,
   [in] LONG                lFlags,
   [in] VARIANT*            pQualifierValue,
   [out] SAFEARRAY (BSTR)** pstrNames
);

Parametry

vFunc
[w] Ten parametr jest nieużywany.

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

wszQualifierName
[w] Wskaźnik prawidłowy LPCWSTR określający nazwę kwalifikatora, która działa jako część filtru. Aby uzyskać więcej informacji, zobacz sekcję Uwagi . Ten parametr może mieć wartość null.

lFlags
[w] Kombinacja pól bitowych. Aby uzyskać więcej informacji, zobacz sekcję Uwagi .

pQualifierValue [w] Wskaźnik do prawidłowej VARIANT struktury zainicjowanej do wartości filtru. Ten parametr może mieć wartość null.

pstrNames
[out] Struktura zawierająca SAFEARRAY nazwy właściwości. W przypadku wpisu ten parametr musi zawsze być wskaźnikiem do null. Aby uzyskać więcej informacji, zobacz sekcję Uwagi .

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_INVALID_PARAMETER 0x80041008 Co najmniej jeden parametr jest nieprawidłowy lub określono nieprawidłową kombinację flag i parametrów.
WBEM_E_OUT_OF_MEMORY 0x80041006 Za mało pamięci jest dostępna do ukończenia operacji.
WBEM_S_NO_ERROR 0 Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

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

Nazwa zwracana jest kontrolowana przez kombinację flag i parametrów. Na przykład funkcja może zwrócić nazwy wszystkich właściwości lub tylko nazwy właściwości klucza. Filtr podstawowy jest określony w parametrze lFlags , a inne parametry różnią się w zależności od niego.

Wartości flagi w pliku lFlags to pola bitowe

Flagi, które można przekazać jako lEnumFlags argument, to pola bitowe zdefiniowane w pliku nagłówka WbemCli.h lub można je zdefiniować jako stałe w kodzie. Możesz połączyć jedną flagę z każdej grupy z dowolną flagą z dowolnej innej grupy. Jednak flagi z tej samej grupy wzajemnie się wykluczają.

Flagi grupy 1 Wartość Opis
WBEM_FLAG_ALWAYS 0 Zwraca wszystkie nazwy właściwości. strQualifierName i pQualifierVal są nieużywane.
WBEM_FLAG_ONLY_IF_TRUE 1 Zwracaj tylko właściwości, które mają kwalifikator nazwy określonej przez strQualifierName parametr . Jeśli ta flaga jest używana, należy określić strQualifierNamewartość .
WBEM_FLAG_ONLY_IF_FALSE 2 Zwracaj tylko właściwości, które nie mają kwalifikatora nazwy określonej przez strQualifierName parametr . Jeśli ta flaga jest używana, należy określić strQualifierNamewartość .
WBEM_FLAG_ONLY_IF_IDENTICAL 3 Zwracaj tylko właściwości, które mają kwalifikator nazwy określonej przez wszQualifierName parametr, a także mają wartość identyczną z właściwością określoną przez pQualifierVal strukturę. Jeśli ta flaga jest używana, należy określić zarówno element , jak wszQualifierName i .pQualifierValue
Flagi grupy 2 Wartość Opis
WBEM_FLAG_KEYS_ONLY 0x4 Zwraca tylko nazwy właściwości definiujących klucze.
WBEM_FLAG_REFS_ONLY 0x8 Zwracaj tylko nazwy właściwości, które są odwołaniami do obiektów.
Flagi grupy 3 Wartość Opis
WBEM_FLAG_LOCAL_ONLY 0x10 Zwracaj tylko nazwy właściwości, które należą do najbardziej pochodnej klasy. Wyklucz właściwości z klas nadrzędnych.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Zwracaj tylko nazwy właściwości należących do klas nadrzędnych.
WBEM_FLAG_SYSTEM_ONLY 0x30 Zwracaj tylko nazwy właściwości systemowych.
WBEM_FLAG_NONSYSTEM_ONLY 0x40 Zwraca tylko nazwy właściwości innych niż system.

Funkcja zawsze przydziela nową wartość SAFEARRAY , jeśli zwraca WBEM_S_NO_ERRORwartość , i pstrNames zawsze jest ustawiona tak, aby wskazywała ją. Zwrócona tablica może zawierać 0 elementów, jeśli żadne właściwości nie są zgodne z określonymi filtrami. Jeśli funkcja zwraca wartość inną niż WBM_S_NO_ERROR, nowa SAFEARRAY struktura nie jest zwracana.

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