MI_ContextFT structure (mi.h)

A support structure used in the MI_Context structure. Use the functions with the name prefix "MI_Context_" to manipulate these structures.

Syntax

typedef struct _MI_ContextFT {
  MI_Result()(MI_Context *context,MI_Result result) * PostResult;
  MI_Result((MI_Context *context, const MI_Instance *instance) * )PostInstance;
  MI_Result(MI_Context *context, const MI_Instance *indication,MI_Uint32 subscriptionIDCount, const MI_Char *bookmark) * )(PostIndication;
  MI_Result(MI_Context *context, const MI_ClassDecl *classDecl,MI_Instance *instance) * )(ConstructInstance;
  MI_Result(MI_Context *context, const MI_MethodDecl *methodDecl,MI_Instance *instance) * )(ConstructParameters;
  MI_Result(I_Context *context, const MI_ClassDecl *classDecl,MI_Instance **instance) * )(MNewInstance;
  MI_Result(I_Context *context, const MI_Char *className,MI_Uint32 flags,MI_Instance **instance) * )(MNewDynamicInstance;
  MI_Result(I_Context *context, const MI_MethodDecl *methodDecl,MI_Instance **instance) * )(MNewParameters;
  MI_Result((const MI_Context *context,MI_Boolean *flag) * )Canceled;
  MI_Result()(const MI_Context *context,MI_LocaleType localeType,MI_Char locale * GetLocale[MI_MAX_LOCALE_SIZE];
  MI_Result((MI_Context *context,MI_CancelCallback callback, void *callbackData) * )RegisterCancel;
  MI_Result()(MI_Context *context) * RequestUnload;
  MI_Result()(MI_Context *context) * RefuseUnload;
  MI_Result((const MI_Context *context,MI_Session *session) * )GetLocalSession;
  MI_Result(MI_Context *context, const MI_Char *name, const MI_Char *value) * )(SetStringOption;
  MI_Result(I_Context *context, const MI_Char *name, const MI_Char **value) * )(MGetStringOption;
  MI_Result(MI_Context *context, const MI_Char *name,MI_Uint32 *value) * )(GetNumberOption;
  MI_Result(I_Context *context, const MI_Char *name,MI_Type *valueType,MI_Value *value) * )(MGetCustomOption;
  MI_Result((MI_Context *context,MI_Uint32 *count) * )GetCustomOptionCount;
  MI_Result(_Context *context,MI_Uint32 index, const MI_Char **name,MI_Type *valueType,MI_Value *value) * )(MIGetCustomOptionAt;
  MI_Result((MI_Context *context,MI_Uint32 channel, const MI_Char *message) * )WriteMessage;
  MI_Result(I_Context *context, const MI_Char *activity, const MI_Char *currentOperation, const MI_Char *statusDescription,MI_Uint32 percentComplete,MI_Uint32 secondsRemaining) * )(MWriteProgress;
  MI_Result(MI_Context *context, const MI_Char *name, const MI_Value *value,MI_Type type,MI_Uint32 flags) * )(WriteStreamParameter;
  MI_Result(MI_Context *context, const MI_Instance *error,MI_Boolean *flag) * )(WriteCimError;
  MI_Result(MI_Context *context, const MI_Char *message,MI_PromptType promptType,MI_Boolean *result) * )(PromptUser;
  MI_Result(I_Context *context, const MI_Char *target, const MI_Char *action,MI_Boolean *result) * )(MShouldProcess;
  MI_Result(MI_Context *context, const MI_Char *message,MI_Boolean *result) * )(ShouldContinue;
  MI_Result(MI_Context *context,MI_Uint32 resultCode, const MI_Char *resultType, const MI_Char *errorMessage) * )(PostError;
  MI_Result((MI_Context *context, const MI_Instance *error) * )PostCimError;
  MI_Result(I_Context *context,MI_Uint32 resultCode, const MI_Char *resultType, const MI_Char *errorMessage,MI_Boolean *flag) * )(MWriteError;
} MI_ContextFT;

Members

PostResult

Providers call this function to post a return code to the server in response to a request. See MI_Context_PostResult.

PostInstance

Providers call this function to post an instance to the server in response to a request. See MI_Context_PostInstance.

PostIndication

Posts an indication to the server in response to a request. See MI_Context_PostIndication.

ConstructInstance

Initializes an instance. See MI_Context_ConstructInstance.

ConstructParameters

Initialize a parameters instance. See MI_Context_ConstructParameters.

NewInstance

Creates a new instance of the class given by the classDecl parameter. See MI_Context_NewInstance.

NewDynamicInstance

Creates a new dynamic instance of the class whose name is given by className. See MI_Context_NewDynamicInstance.

NewParameters

Creates a new instance of the method given by methodDecl. See MI_Context_NewParameters.

Canceled

Determines whether the operation has been canceled. See MI_Context_Canceled.

GetLocale[MI_MAX_LOCALE_SIZE]

Returns the locale of the given type. See MI_Context_GetLocale.

RegisterCancel

Registers a callback that is invoked when the operation is canceled. See MI_Context_RegisterCancel.

RequestUnload

Requests to unload the module or the provider (depending on the location of invocation). See MI_Context_RequestUnload.

RefuseUnload

Tells the provider infrastructure to not unload the provider. See MI_Context_RefuseUnload.

GetLocalSession

Gets the local session allowing the provider to communicate with the CIM server. See MI_Context_GetLocalSession.

SetStringOption

Sets a context-specific option. See MI_Context_SetStringOption.

GetStringOption

Gets the specified provider custom option. See MI_Context_GetStringOption.

GetNumberOption

Gets the specified provider custom option. See MI_Context_GetNumberOption.

GetCustomOption

Gets the specified provider custom option. See MI_Context_GetCustomOption.

GetCustomOptionCount

Gets the count of defined provider custom options. See MI_Context_GetCustomOptionCount.

GetCustomOptionAt

Gets the provider's custom option at the specified index. See MI_Context_GetCustomOptionAt.

WriteMessage

Sends an operational message to the client. See MI_Context_WriteMessage.

WriteProgress

Sends a progress message to the client. See MI_Context_WriteProgress.

WriteStreamParameter

Sends streamed parameter data to the requestor. See MI_Context_WriteStreamParameter.

WriteCimError

Sends a CIM error instance to the client. See MI_Context_WriteCimError.

PromptUser

Sends a prompt message to the client querying whether to continue the operation or cancel it. See MI_Context_PromptUser.

ShouldProcess

Queries the client to determine if an operation should continue. See MI_Context_ShouldProcess.

ShouldContinue

Queries the client to determine if an operation should continue. See MI_Context_ShouldContinue.

PostError

Providers call this function to post a return code to the client in response to a request. See MI_Context_PostError.

PostCimError

Posts a return code and an error message to the server in response to a request. See MI_Context_PostCimError.

WriteError

This function has been deprecated. Use MI_Context_WriteError instead.

Sends an error code and error message to the client. See MI_Context_WriteError.

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Header mi.h
Redistributable Windows Management Framework 3.0 on Windows Server 2008 R2 with SP1, Windows 7 with SP1, and Windows Server 2008 with SP2