MI_Context_GetLocalSession函式 (mi.h)

取得本機會話 (MI_Session) ，讓提供者能夠對裝載提供者的本地伺服器執行 CIM 作業。

語法

MI_INLINE MI_Result MI_INLINE_CALL MI_Context_GetLocalSession(
  [in]  const MI_Context *context,
  [out] MI_Session       *session
);

參數

[in] context

要求內容的指標。

[out] session

傳回 之MI_Session 物件的指標。 此工作階段不得關閉。

傳回值

指定函式傳回碼的 MI_Result 列舉值。 這可以是下列其中一個程序代碼。

備註

此會話會預先具現化，並具有從中取得會話的內容存留期。 提供者不得關閉此會話，因為其存留期系結至內容。

提供者應該呼叫此函式，而不是透過 MI_Application_NewSession 函式建立新的會話，因為某些優化可能會與 CIM 伺服器交談。

用來呼叫 MI_Context_GetLocalSession 函式的安全性內容應該與透過 MI_Session_* 作業函式向伺服器通訊的相同身分識別。 請勿在目前作業之外快取這些會話。 提供者在不同身分識別的作業內多次呼叫這個方法，在此情況下，擷取的會話也應該與相同的身分識別搭配使用。 會話上的任何作業應該一律與使用者針對本機會話擷取的身分識別相同，否則作業可能會因為傳回碼 MI_RESULT_ACCESS_DENIED 失敗。

規格需求

需求	值
最低支援的用戶端	Windows 8
最低支援的伺服器	Windows Server 2012
目標平台	Windows
標頭	mi.h
可轉散發套件	windows Server 2008 R2 SP1、Windows 7 SP1 和 Windows Server 2008 SP2 上的 Windows Management Framework 3.0