Compartilhar via

função MI_Session_Close (mi.h)

  • Artigo

Fecha uma sessão e libera toda a memória associada.

Sintaxe

MI_INLINE MI_Result MI_Session_Close(
  [in, out]      MI_Session                        *session,
  [in, optional] void                              *completionContext,
  [in, out]      void(* )(void *completionContext) completionCallback
);

Parâmetros

[in, out] session

Identificador de sessão retornado de MI_Application_NewSession.

[in, optional] completionContext

Parâmetro opcional a ser retornado por meio do retorno de chamada completionCallback .

[in, out] completionCallback

Retorno de chamada opcional para tornar a sessão assíncrona próxima. (Se esse valor for NULL, a chamada de fechamento será síncrona.) Se o MI_Session_Close for chamado de um retorno de chamada, o retorno de chamada de conclusão deverá ser especificado. Não fazer isso pode resultar em um deadlock.

completionContext

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

O fechamento de uma sessão fará com que todas as operações que estão em execução sejam canceladas no momento. O cancelamento de operações fará com que os retornos de chamada de operação assíncrona sejam chamados (com o resultado final de um parâmetro moreResults da chamada de função MI_Operation_Get* igual a MI_FALSE, embora mais de um resultado possa ser entregue antes que isso aconteça). Não fechar todos os identificadores de operação criados com a sessão atual fará com que o fechamento da sessão pare de responder por chamadas síncronas e o retorno de chamada assíncrono não será chamado. Os identificadores de operação e sessão não totalmente fechados farão com que o identificador do aplicativo pare de responder durante o desligamento.

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