MI_Session_CreateInstance函式 (mi.h)

在工作階段所代表的伺服器上建立 實例。

語法

MI_INLINE void MI_Session_CreateInstance(
  [in]           MI_Session            *session,
                 MI_Uint32             flags,
  [in, optional] MI_OperationOptions   *options,
                 const MI_Char         *namespaceName,
  [in]           const MI_Instance     *inboundInstance,
  [in, optional] MI_OperationCallbacks *callbacks,
  [out]          MI_Operation          *operation
);

參數

[in] session

從 MI_Application_NewSession 傳回的會話句柄。

flags

運行時間類型資訊 (RTTI) 旗標。

[in, optional] options

選擇性 MI_OperationOptions 值，指定逾時等選項，以及如何控制 CIM 語意。 如果未傳送任何作業選項，請指定 Null 。

namespaceName

以 Null 結尾的字串，其中包含執行作業的選擇性命名空間名稱。 如果未指定任何專案，伺服器會挑選預設值。 命名空間不能包含計算機名稱。 它只能以 /) 斜線字元分隔的命名空間名稱形式 (。 例如，下列是有效的 namespaceName 值： root/cimv2。

[in] inboundInstance

MI_Instance ，代表伺服器上要建立之實例的類別名稱和索引鍵，以及目的地實例將設定為之實例的其餘屬性。 有時候索引鍵是唯讀的，因此不需要指定所有金鑰。 如果指定的實例已經存在，函式將會失敗;若要更新現有的實例，請使用 MI_Session_ModifyInstance 函式。

[in, optional] callbacks

選擇性 MI_OperationCallbacks 結構，定義接收實例結果和 CIM 語意的操作回呼。 若要以異步方式執行，必須指定此值。 如果指定 NULL，客戶端必須呼叫 MI_Operation_GetInstance 函式來擷取結果。

[out] operation

作業完成且收到所有結果之後，必須以呼叫 MI_Operation_Close 關閉的作業句柄。 句柄可用來取消作業，並呼叫 MI_Operation_Cancel。

傳回值

無

規格需求

另請參閱

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance

MI_Session_ModifyInstance