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
会话的可选目标。 如果 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 协议。 如果未指定任何协议且 destination 不为 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 |