SpawnInstance function

Artikkeli
09/15/2021

Creates a new instance of a class.

Note

This API is for internal use only. It's not intended for use from developer code.

Syntax

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

Parameters

vFunc
[in] This parameter is unused.

ptr
[in] A pointer to an IWbemClassObject instance.

lFlags
[in] Reserved. This parameter must be 0.

ppNewInstance
[out] Receives the pointer to the new instance of the class. If an error occurs, a new object is not returned, and ppNewInstance is left unmodified.

Return value

The following values returned by this function are defined in the WbemCli.h header file, or you can define them as constants in your code:

Constant	Value	Description
`WBEM_E_INCOMPLETE_CLASS`	0x80041020	`ptr` is not a valid class definition and cannot spawn new instances. Either it is incomplete or it has not been registered with Windows Management by calling PutClassWmi.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Not enough memory is available to complete the operation.
`WBEM_E_INVALID_PARAMETER`	0x80041008	`ppNewClass` is `null`.
`WBEM_S_NO_ERROR`	0	The function call was successful.

Remarks

This function wraps a call to the IWbemClassObject::SpawnInstance method.

ptr must be a class definition obtained from Windows Management. (Note that spawning an instance from an instance is supported but the returned instance is empty.) You then use this class definition to create new instances. A call to the PutInstanceWmi function is required if you intend to write the instance to Windows Management.

The new object returned in ppNewClass automatically becomes a subclass of the current object. This behavior cannot be overridden. There is no other method by which subclasses (derived classes) can be created.

Requirements

Platforms: See System Requirements.

Header: WMINet_Utils.idl

.NET Framework Versions: Available since 4.7.2

Jaa