MI_Context_NewInstance function (mi.h)

Creates a new instance of a class given a class declaration.

Syntax

MI_INLINE MI_Result MI_INLINE_CALL MI_Context_NewInstance(
  [in] MI_Context         *context,
  [in] const MI_ClassDecl *classDecl,
       MI_Instance        **instance
);

Parameters

[in] context

A pointer to the request context.

[in] classDecl

A pointer to the class declaration used to initialize the instance. The runtime type information (RTTI) is generated for the class and should be named for the class, followed by an "_rtti" suffix.

instance

A pointer to the returned instance. There is also a generated function named for the class, followed by a "_Delete" suffix.

Return value

A value of the MI_Result enumeration that specifies the function return code. This can be one of the following codes.

Remarks

When you are finished using the instance, it must be deleted via the MI_Instance_Delete function.

Requirements