MI_Session_Close函式 (mi.h)
關閉工作階段並釋放所有相關聯的記憶體。
語法
MI_INLINE MI_Result MI_Session_Close(
[in, out] MI_Session *session,
[in, optional] void *completionContext,
[in, out] void(* )(void *completionContext) completionCallback
);
參數
[in, out] session
從 MI_Application_NewSession 傳回的會話句柄。
[in, optional] completionContext
要透過 completionCallback 回 呼傳回的選擇性參數。
[in, out] completionCallback
選擇性回呼,讓會話關閉異步。 (如果此值為 NULL,則關閉呼叫為同步。) 如果從回呼呼叫 MI_Session_Close ,則必須指定完成回呼。 不這麼做可能會導致死結。
completionContext
傳回值
指定函式傳回碼 之MI_Result 列舉的值。 這可以是下列其中一個程序代碼。
備註
關閉會話會導致目前正在執行的所有作業都取消。 取消作業會導致異步操作回呼呼叫 (,而MI_Operation_Get* 函式呼叫的 moreResults 參數等於 MI_FALSE的最終結果,不過在發生此情況之前,可能會傳遞多個結果) 。 未關閉使用目前會話建立的所有作業句柄,會導致會話關閉以停止回應同步呼叫,而且不會呼叫異步回呼。 未完全關閉的作業和會話句柄會導致應用程式句柄在關機期間停止回應。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 |
最低支援的伺服器 | Windows Server 2012 |
目標平台 | Windows |
標頭 | mi.h |
可轉散發套件 | 在 Windows Server 2008 R2 上 Windows Management Framework 3.0 SP1、Windows 7 SP1 和 Windows Server 2008 SP2 |