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