MI_ProviderFT_GetInstance function pointer

Get a single CIM instance from the provider.

Syntax

typedef void ( MI_CALL *MI_ProviderFT_GetInstance)(
  _In_opt_       void           *self,
  _In_           MI_Context     *context,
  _In_     const MI_Char        *nameSpace,
  _In_     const MI_Char        *className,
  _In_     const MI_Instance    *instanceName,
  _In_opt_ const MI_PropertySet *propertySet
);

Parameters

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

  • context [in]
    The request context.

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

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

  • instanceName [in]
    Get an instance with this name.

  • propertySet [in, optional]
    The names of properties to include or NULL for all.

Return value

This function pointer does not return a value.

Remarks

If successful, the provider should post the 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_INVALID_NAMESPACE

MI_RESULT_INVALID_PARAMETER

MI_RESULT_INVALID_CLASS

MI_RESULT_NOT_FOUND

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_Filter

MI_Instance

MI_PropertySet