função MI_Context_GetLocalSession (mi.h)

Obtém a sessão local (MI_Session) que permite que o provedor execute operações CIM no servidor local que hospeda o provedor.

Sintaxe

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

Parâmetros

[in] context

Um ponteiro para o contexto da solicitação.

[out] session

Um ponteiro para o objeto MI_Session retornado. Esta sessão não deve ser fechada.

Retornar valor

Um valor da enumeração MI_Result que especifica o código de retorno da função. Esse pode ser um dos códigos a seguir.

Comentários

Essa sessão é pré-instanciada e tem o tempo de vida do contexto do qual a sessão foi obtida. O provedor não deve fechar esta sessão porque seu tempo de vida está associado ao contexto.

O provedor deve chamar essa função em vez de criar uma nova sessão por meio da função MI_Application_NewSession , pois algumas otimizações podem ser possíveis para falar com o servidor CIM.

O contexto de segurança usado para chamar a função MI_Context_GetLocalSession deve ser a mesma identidade usada para se comunicar com o servidor por meio das funções de operação MI_Session_*. Não armazene essas sessões em cache fora da operação atual. O provedor chama esse método várias vezes dentro de uma operação em identidades diferentes. Nesse caso, a sessão recuperada também deve ser usada com a mesma identidade. Todas as operações na sessão devem ser sempre a mesma identidade que o usuário recuperou para a sessão local ou então a operação pode falhar com o código de retorno MI_RESULT_ACCESS_DENIED .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Windows
Cabeçalho	mi.h
Redistribuível	Windows Management Framework 3.0 no Windows Server 2008 R2 com SP1, Windows 7 com SP1 e Windows Server 2008 com SP2