Expand Minimize

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

 

 

Show:
© 2014 Microsoft