Skip to main content
MI_Application_NewInstance function

Creates a new MI_Instance object to be passed to various MI operation APIs that require instances.

Syntax


 MI_INLINE MI_Result MI_Application_NewInstance(
  _In_      MI_Application *application,
  _In_z_ const MI_Char *className,
  _In_opt_  const MI_ClassDecl *classRTTI,
  _Outptr_ MI_Instance **instance
);

Parameters

application [in]

A pointer to a handle returned from a call to the MI_Application_Initialize function.

className

The class name for the instance being created.

classRTTI [in, optional]

A pointer to optional run time type information for the object being created.

instance

A pointer to the instance returned from this function call.

Return value

Return codeDescription
MI_RESULT_OK

The operation succeeded.

MI_RESULT_SERVER_LIMITS_EXCEEDED

There is not enough memory to complete the request.

MI_RESULT_INVALID_PARAMETER

One or more parameters passed to the function were not valid.

MI_RESULT_FAILED

A failure not covered by other MI_Result error codes.

 

Remarks

When you have finished using the instance created by this call, delete it by calling the MI_Instance_Delete function.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Redistributable

Windows Management Framework 3.0 on Windows Server 2008 R2 with SP1, Windows 7 with SP1, and Windows Server 2008 with SP2

Header

Mi.h