Funzione SpawnDerivedClass

Articolo
05/10/2023

Crea un nuovo oggetto di classe derivata da un oggetto specificato.

Nota

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

Sintassi

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

Parametri

vFunc
[in] Questo parametro è inutilizzato.

ptr
[in] Puntatore a un'istanza di IWbemClassObject .

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

ppNewClass
[out] Riceve il puntatore al nuovo oggetto definizione di classe. Se si verifica un errore, un nuovo oggetto non viene restituito e ppNewClass viene lasciato non modificato. Il valore non può essere null.

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_FAILED`	0x80041001	Si è verificato un errore generale.
`WBEM_E_INVALID_OPERATION`	0x80041016	È stata richiesta un'operazione non valida, ad esempio la generazione di una classe da un'istanza.
`WBEM_E_INCOMPLETE_CLASS`		La classe di origine non è stata completamente definita o registrata con Gestione Windows, quindi una nuova classe derivata non è consentita.
`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 alla funzione ha avuto esito positivo.

Commenti

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

ptr deve essere una definizione di classe che diventa la classe padre dell'oggetto generato. L'oggetto restituito diventa una sottoclasse dell'oggetto corrente.

Il nuovo oggetto restituito in ppNewClass diventa automaticamente una sottoclasse dell'oggetto corrente. Questo comportamento non può essere sottoposto a override. Non è disponibile alcun altro metodo per cui è possibile creare sottoclassi (classi derivate).

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile da 4.7.2

Vedi anche

WMI e contatori delle prestazioni (riferimenti alle API non gestite)

Condividi tramite