Udostępnij przez

SpawnInstance, funkcja

Tworzy nowe wystąpienie klasy.

Uwaga

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

Składnia

HRESULT SpawnInstance (
   [in] int                  vFunc,
   [in] IWbemClassObject*    ptr,
   [in] LONG                 lFlags,
   [out] IWbemClassObject**  ppNewInstance);

Parametry

vFunc
[in] Ten parametr jest nieużywany.

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

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

ppNewInstance
[out] Odbiera wskaźnik do nowego wystąpienia klasy. Jeśli wystąpi błąd, nowy obiekt nie zostanie zwrócony i ppNewInstance pozostanie niezmodyfikowany.

Wartość zwracana

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

Stała Wartość Opis
WBEM_E_INCOMPLETE_CLASS 0x80041020 ptr nie jest prawidłową definicją klasy i nie może zduplikować nowych wystąpień. Jest on niekompletny lub nie został zarejestrowany w usłudze Windows Management przez wywołanie metody PutClassWmi.
WBEM_E_OUT_OF_MEMORY 0x80041006 Za mało pamięci, aby ukończyć operację.
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 opakowuje wywołanie metody IWbemClassObject::SpawnInstance .

ptr musi być definicją klasy uzyskaną z zarządzania systemem Windows. (Należy pamiętać, że zduplikowanie wystąpienia z wystąpienia jest obsługiwane, ale zwrócone wystąpienie jest puste). Następnie użyjesz tej definicji klasy do utworzenia nowych wystąpień. Wywołanie funkcji PutInstanceWmi jest wymagane, jeśli zamierzasz zapisać wystąpienie w usłudze Windows Management.

Nowy obiekt zwracany 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 tworzyć podklasy (klasy pochodne).

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

wersje .NET Framework: dostępne od wersji 4.7.2

Zobacz też

  • Last updated on