MI_Application_NewOperationOptions function (mi.h)

Creates an MI_OperationOptions object that can be used with the operation functions on the MI_Session object.

Syntax

MI_INLINE MI_Result MI_Application_NewOperationOptions(
  [in]  MI_Application      *application,
        MI_Boolean          mustUnderstand,
  [out] MI_OperationOptions *options
);

Parameters

[in] application

A pointer to a handle returned from the MI_Application_Initialize function.

mustUnderstand

Specifies if the transport and provider are required to process the options being passed. This should be set to MI_FALSE. Setting this parameter to MI_TRUE can cause the operation to fail if the server cannot process one of the options.

[out] options

A pointer to an options handle returned from this function.

Return value

This function returns MI_INLINE MI_Result.

Remarks

When you have finished using the object returned from this call, delete it by calling the MI_OperationOptions_Delete function.

Requirements