MI_Session_GetInstance函式 (mi.h)

從工作階段所表示的伺服器取得指定的實例。

語法

MI_INLINE void MI_Session_GetInstance(
  [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 物件，表示要從伺服器擷取之實例的類別名稱和索引鍵。

[in, optional] callbacks

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

[out] operation

傳回的作業句柄，必須在完成之後，透過 MI_Operation_Close 關閉 。 在完成之前 呼叫MI_Operation_Cancel 會導致作業關閉。 您可以從任何作業呼叫MI_Operation_Close和MI_Operation_Cancel。

傳回值

無

備註

若要使用此函式，請建立僅限密鑰的實例，並將它傳遞至 MI_Session_GetInstance。 接著會傳回完整的實例。

規格需求

另請參閱

MI_Application_NewSession

MI_OperationCallbacks

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance