Condividi tramite

Funzione SpawnInstance

Crea una nuova istanza di una classe.

Nota

Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.

Sintassi

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

Parametri

vFunc
[in] Questo parametro non è usato.

ptr
[in] Puntatore a un'istanza IWbemClassObject .

lFlags
[in] Riservato. Questo parametro deve essere 0.

ppNewInstance
[out] Riceve il puntatore alla nuova istanza della classe . Se si verifica un errore, non viene restituito un nuovo oggetto e ppNewInstance viene lasciato invariato.

Valore restituito

I valori seguenti restituiti da questa funzione sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice:

Costante Valore Descrizione
WBEM_E_INCOMPLETE_CLASS 0x80041020 ptr non è una definizione di classe valida e non può generare nuove istanze. È incompleta o non è stata registrata con Gestione Windows chiamando PutClassWmi.
WBEM_E_OUT_OF_MEMORY 0x80041006 Memoria insufficiente per completare l’operazione.
WBEM_E_INVALID_PARAMETER 0x80041008 ppNewClass è null.
WBEM_S_NO_ERROR 0 La chiamata di funzione ha avuto esito positivo.

Commenti

Questa funzione esegue il wrapping di una chiamata al metodo IWbemClassObject::SpawnInstance .

ptr deve essere una definizione di classe ottenuta da Gestione Windows. Si noti che la generazione di un'istanza da un'istanza è supportata, ma l'istanza restituita è vuota. Usare quindi questa definizione di classe per creare nuove istanze. Se si intende scrivere l'istanza in Gestione Windows, è necessaria una chiamata alla funzione PutInstanceWmi .

Il nuovo oggetto restituito in ppNewClass diventa automaticamente una sottoclasse dell'oggetto corrente. Non è possibile eseguire l'override di questo comportamento. Non esiste un altro metodo in base al quale è possibile creare sottoclassi (classi derivate).

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile dalla versione 4.7.2

Vedi anche

  • Last updated on