MI_Context_GetLocalSession función (mi.h)

Obtiene la sesión local (MI_Session) que permite al proveedor realizar operaciones CIM en el servidor local que hospeda el proveedor.

Sintaxis

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

Parámetros

[in] context

Puntero al contexto de la solicitud.

[out] session

Puntero al objeto de MI_Session devuelto. Esta sesión no debe cerrarse.

Valor devuelto

Valor de la enumeración MI_Result que especifica el código de retorno de la función. Puede ser uno de los códigos siguientes.

Comentarios

Esta sesión se crea previamente y tiene la duración del contexto desde el que se obtuvo la sesión. El proveedor no debe cerrar esta sesión porque su duración está enlazada al contexto.

El proveedor debe llamar a esta función en lugar de crear una nueva sesión a través de la función MI_Application_NewSession , ya que algunas optimizaciones pueden ser posibles para comunicarse con el servidor CIM.

El contexto de seguridad usado para llamar a la función MI_Context_GetLocalSession debe ser la misma identidad que se usa para comunicarse con el servidor a través de las funciones de operación MI_Session_*. No almacene en caché estas sesiones fuera de la operación actual. El proveedor llama a este método varias veces dentro de una operación en identidades diferentes, en cuyo caso la sesión recuperada también se debe usar con la misma identidad. Las operaciones de la sesión siempre deben ser la misma identidad que el usuario recuperó para la sesión local o, de lo contrario, la operación podría producir un error con el código de devolución MI_RESULT_ACCESS_DENIED .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Windows
Encabezado	mi.h
Redistribuible	Windows Management Framework 3.0 en Windows Server 2008 R2 con SP1, Windows 7 con SP1 y Windows Server 2008 con SP2