MI_Operation_GetInstance函式 (mi.h)

取得實例作業的同步結果。

語法

MI_INLINE MI_Result MI_Operation_GetInstance(
  [in]            MI_Operation      *operation,
                  const MI_Instance **instance,
  [out, optional] MI_Boolean        *moreResults,
  [out, optional] MI_Result         *result,
                  const MI_Char     **errorMessage,
                  const MI_Instance **completionDetails
);

參數

[in] operation

從實例會話作業傳回的作業句柄。

instance

傳回的實例。 即使作業成功，這個值也可能是 Null 。 傳回的實例有效，直到下一次呼叫 MI_Operation_GetInstance 或 MI_Operation_Close為止。 如果實例必須在這些呼叫之間保持作用中，則必須透過 MI_Instance_Clone 複製 類別。

[out, optional] moreResults

傳回布爾值，指出是否有更多結果可用。 MI_TRUE 值表示可以 擷取更多結果。 必須呼叫此函式，直到 moreResults 的值MI_FALSE ( ，即使透過 MI_Operation_Cancel) 取消作業也一樣。 在擷取最後一個結果之前呼叫 MI_Operation_Close，其中moreResults設定為MI_FALSE會導致MI_Operation_Close函式停止回應。

[out, optional] result

傳回值，表示函數調用的成功或失敗。 值MI_RESULT_OK表示成功。 否則，應該使用傳回 的 errorMessage 值來判斷失敗的原因。

errorMessage

如果發生錯誤，這個傳回的值會提供失敗原因的其他偵錯資訊。 此錯誤訊息的存留期與 classResult 值相同。

completionDetails

如果是錯誤，這個傳回的值會提供額外的錯誤資訊，通常是 CIM_Error物件 ( 或衍生類別的形式) 。 這個傳回的實例與 classResult 值具有相同的存留期。 如果此值需要保持作用中時間較長，則必須透過 MI_Instance_Clone 複製值。

傳回值

無

備註

系統會呼叫此函式，以取得所有實例作業的所有同步結果，但訂用帳戶除外，其中應該使用 MI_Operation_GetIndication 。 此函式會封鎖，直到有結果可用為止。 它應該呼叫，直到 傳回 moreResults 參數的值 為 MI_FALSE 為止。 如果已註冊實例回呼，呼叫此函式就會發生錯誤。

規格需求