MI_OperationCallbacks structure (mi.h)

Structure that holds all callback function pointers for carrying out operations.

Syntax

typedef struct _MI_OperationCallbacks {
  void                                   *callbackContext;
  MI_OperationCallback_PromptUser        promptUser;
  MI_OperationCallback_WriteError        writeError;
  MI_OperationCallback_WriteMessage      writeMessage;
  MI_OperationCallback_WriteProgress     writeProgress;
  MI_OperationCallback_Instance          instanceResult;
  MI_OperationCallback_Indication        indicationResult;
  MI_OperationCallback_Class             classResult;
  MI_OperationCallback_StreamedParameter streamedParameterResult;
} MI_OperationCallbacks;

Members

callbackContext

A client specific context that is passed to all the callbacks. This is used to correlate the callback to the associated operation. This value will be passed to any operation callbacks.

promptUser

Optional callback to handle prompt user requests from the server.

writeError

Optional callback to receive write error messages from the server.

writeMessage

Optional callback to receive write messages from the server.

writeProgress

Optional callback to receive progress reports from the server.

instanceResult

Optional instance callback to get asynchronous results from an operation. If this is not specified and the operation is an instance operation, then the client will need to use the synchronous APIs to retrieve the results.

indicationResult

Optional instance callback to get indication (subscribe) results from an operation. If this is not specified and the operation is an instance operation, then the client will need to use the synchronous APIs to retrieve the results.

classResult

Optional instance callback to get classes and class options from an operation. If this is not specified and the operation is an instance operation, then the client will need to use the synchronous APIs to retrieve the results.

streamedParameterResult

Optional callback to get streamed parameter results from method invocation operations.

Remarks

All PowerShell Semantics and streamed result callbacks are optional; include the callbacks you want to receive. If the associated operation callback for the operation is not set, i.e. set to NULL, the operation will be carried out synchronously. The client must call into the appropriate MI_Operation function to receive the results. The result callbacks will continue to be called until the moreResults field is equal to MI_FALSE.

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

See also

MI_OperationCallback_Class

MI_OperationCallback_Indication

MI_OperationCallback_Instance

MI_OperationCallback_PromptUser

MI_OperationCallback_StreamedParameter

MI_OperationCallback_WriteError

MI_OperationCallback_WriteMessage

MI_OperationCallback_WriteProgress