MI_Session_Invoke函式 (mi.h)

叫用提供者中的方法。

語法

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

參數

[in] session

從 MI_Application_NewSession 傳回的會話句柄。

flags

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

[in, optional] options

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

[in, optional] namespaceName

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

[in, optional] className

選擇性且以 Null 結尾的字串，代表方法所屬類別的名稱。 傳入輸入時應為 Null。

[in] methodName

以 Null 結束的字串，表示要叫用的方法名稱。

[in, optional] inboundInstance

具有索引鍵的實例，指定要叫用的方法。 如果 為 Null，則方法必須是靜態的。

[in, optional] inboundProperties

輸入方法屬性。 每個輸入屬性都必須是 實例中的專案，而且元素名稱必須與方法參數的名稱相同。

[in, optional] callbacks

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

[out] operation

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

傳回值

無

備註

方法具有傳回值，這些傳回值會當做輸出實例的 ReturnValue 參數傳回。 可能有輸出屬性會屬於相同結果的一部分。 如果指定串流參數回呼，且任何輸出屬性都標示為已串流處理，則會針對支援串流的每個參數呼叫串流回呼。 系統會呼叫它們，直到擷取所有結果，或直到最終結果傳回為止。

規格需求

另請參閱

MI_Application_NewSession

MI_OperationCallbacks

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance