MI_ProviderFT_CreateInstance function pointer

Create a single CIM instance in the target namespace.

Syntax

typedef void ( MI_CALL *MI_ProviderFT_CreateInstance)(
  _In_opt_       void        *self,
  _In_           MI_Context  *context,
  _In_     const MI_Char     *nameSpace,
  _In_     const MI_Char     *className,
  _In_     const MI_Instance *newInstance
);

Parameters

  • self [in, optional]
    The provider state data.

  • context [in]
    The request context.

  • nameSpace [in]
    Create an instance in this namespace.

  • className [in]
    Create an instance of this class.

  • newInstance [in]
    Defines the instance that will be created. The null properties of this instance are ignored and are not part of the new instance. However, some key properties must be left undefined because they cannot be known by the requestor until they are set by the server.

Return value

This function pointer does not return a value.

Remarks

If successful, the provider should post the new instance by using the MI_Context_PostInstance method.

On completion the implementation must post the result by using the MI_Context_PostResult method. The expected result is one of the following values.

MI_RESULT_OK

MI_RESULT_ACCESS_DENIED

MI_RESULT_NOT_SUPPORTED

MI_RESULT_INVALID_NAMESPACE

MI_RESULT_INVALID_PARAMETER

MI_RESULT_INVALID_CLASS

MI_RESULT_ALREADY_EXISTS

MI_RESULT_FAILED

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

See also

MI_ProviderFT

MI_Context

MI_Instance