MI_ProviderFT_Subscribe function pointer

Subscribe to indications.

Syntax

typedef void ( MI_CALL *MI_ProviderFT_Subscribe)(
  _In_opt_       void       *self,
  _In_           MI_Context *context,
  _In_     const MI_Char    *nameSpace,
  _In_     const MI_Char    *className,
  _In_opt_ const MI_Filter  *filter,
  _In_     const MI_Char    *bookmark,
                 MI_Uint64  subscriptionID,
  _Out_          void       **subscriptionSelf
);

Parameters

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

  • context [in]
    The request context. The same context that was used for the corresponding call to the MI_ProviderFT_EnableIndications method.

  • nameSpace [in]
    TBD

  • className [in]
    TBD

  • filter [in, optional]
    Filter the indications.

  • bookmark [in]
    The starting point of the subscription.

  • subscriptionID
    The unique id of the subscription.

  • subscriptionSelf [out]
    TBD

Return value

This function pointer does not return a value.

Remarks

As events occur, the provider should create indication instances and post them by using MI_Context_PostInstance with the context provided by the MI_ProviderFT_EnableIndications 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_CANCELED

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_ProviderFT_EnableIndications

MI_ProviderFT_Unsubscribe