MI_Application_NewSession函式 (mi.h)
建立會話，用來共用一組作業至單一目的地的連線。
語法
MI_INLINE MI_Result MI_Application_NewSession(
[in] MI_Application *application,
[in, optional] const MI_Char *protocol,
[in, optional] const MI_Char *destination,
[in, optional] MI_DestinationOptions *options,
[in, optional] MI_SessionCallbacks *callbacks,
MI_Instance **extendedError,
[out] MI_Session *session
);
參數
[in] application
從 MI_Application_Initialize 函式傳回之句柄的指標。
[in, optional] protocol
要執行作業的選擇性通訊協議處理程式指標。 如果此參數為 NULL，則會根據目的地使用預設值。 目前支持的通訊協定為 L“WMIDCOM” 和 L“WINRM”
[in, optional] destination
會話的選擇性目的地。 如果目的地自變數為 NULL，會話會與本機計算機通訊。 否則，目的地可以是本機計算機或遠端電腦的計算機名稱。
[in, optional] options
選擇性目的地選項的指標，例如預設逾時和認證。
[in, optional] callbacks
選擇性MI_SessionCallbacks結構的指標，其中包含接收各種結果的回呼。
extendedError
如果作業失敗，則為選擇性其他錯誤資訊的指標。 當您完成使用錯誤資訊時，請呼叫 MI_Instance_Delete 函式來釋放記憶體。
[out] session
傳回之會話句柄的指標。 當您完成會話句柄時，請呼叫 MI_Session_Close 函式 來 關閉它。 如果會話句柄在關閉應用程式與應用程式句柄之前未關閉，則應用程式句柄關閉將不會回應。
傳回值
此函式會傳回MI_INLINE MI_Result。
備註
建立目的地可能不會與目的地計算機通訊。 在應用程式可判斷計算機是否可存取的會話上執行第一個作業之前，將不會如此。
必須在輸出會話句柄上呼叫 MI_Session_Close 函式。 關閉工作階段之前，請先關閉目標工作階段下的所有作業。
如果未指定任何通訊協定，且 目的地 為 NULL，則會使用 WMIDCOM 通訊協定。 如果未指定任何通訊協定，且 目的地 不是 NULL，則會使用 WINRM 通訊協定。 .
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 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 |