SpawnDerivedClass, funkcja

Tworzy nowo pochodny obiekt klasy z określonego 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 SpawnDerivedClass (
   [in] int                  vFunc,
   [in] IWbemClassObject*    ptr,
   [in] LONG                 lFlags,
   [out] IWbemClassObject**  ppNewClass);

Parametry

vFunc
[w] Ten parametr jest nieużywany.

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

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

ppNewClass
[out] Odbiera wskaźnik do nowego obiektu definicji klasy. Jeśli wystąpi błąd, nowy obiekt nie zostanie zwrócony i ppNewClass pozostanie niezmodyfikowany. Jego wartość nie może być nullwartoś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_FAILED	0x80041001	Wystąpiła ogólna awaria.
WBEM_E_INVALID_OPERATION	0x80041016	Zażądano nieprawidłowej operacji, takiej jak spawning klasy z wystąpienia.
WBEM_E_INCOMPLETE_CLASS		Klasa źródłowa nie została całkowicie zdefiniowana lub zarejestrowana w usłudze Windows Management, więc nowa klasa pochodna nie jest dozwolona.
WBEM_E_OUT_OF_MEMORY	0x80041006	Za mało pamięci jest dostępna do ukończenia operacji.
WBEM_E_INVALID_PARAMETER	0x80041008	ppNewClass to null.
WBEM_S_NO_ERROR	0	Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

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

ptr musi być definicją klasy, która staje się klasą nadrzędną obiektu zduplikowanego. Zwrócony obiekt staje się podklasą bieżącego obiektu.

Nowy obiekt zwrócony automatycznie ppNewClass staje się podklasą bieżącego obiektu. Tego zachowania nie można zastąpić. Nie ma innej metody, za pomocą której można utworzyć podklasy (klasy pochodne).

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)