IO_SESSION_STATE enumeração (wdm.h)

Artigo
02/07/2025

A enumeração IO_SESSION_STATE contém constantes que indicam o estado atual de uma sessão de usuário.

Sintaxe

typedef enum _IO_SESSION_STATE {
  IoSessionStateCreated,
  IoSessionStateInitialized,
  IoSessionStateConnected,
  IoSessionStateDisconnected,
  IoSessionStateDisconnectedLoggedOn,
  IoSessionStateLoggedOn,
  IoSessionStateLoggedOff,
  IoSessionStateTerminated,
  IoSessionStateMax
} IO_SESSION_STATE, *PIO_SESSION_STATE;

Constantes


`IoSessionStateCreated` A sessão foi criada.
`IoSessionStateInitialized` A sessão foi inicializada, mas ainda não foi criada.
`IoSessionStateConnected` A sessão está conectada, mas o usuário ainda não fez logon.
`IoSessionStateDisconnected` A sessão foi desconectada.
`IoSessionStateDisconnectedLoggedOn` A sessão foi desconectada enquanto o usuário estava conectado.
`IoSessionStateLoggedOn` O usuário está conectado à sessão.
`IoSessionStateLoggedOff` O usuário fez logon da sessão.
`IoSessionStateTerminated` A sessão foi encerrada.
`IoSessionStateMax` Especifica o valor máximo nesse tipo de enumeração.

Observações

Quando um driver chama a rotina IoGetContainerInformation para obter informações sobre uma sessão de usuário (InformationClass = IoSessionStateInformation), o gerente de E/S grava uma estrutura de IO_SESSION_STATE_INFORMATION no buffer apontado pelo parâmetro Buffer da rotina. O gerente de E/S define o membro SessionState dessa estrutura como uma constante de enumeração IO_SESSION_STATE (diferente de IoSessionStateMax).

A tabela a seguir mostra as transições de estado da sessão. Para cada transição de estado, a tabela mostra o seguinte:

O do estado (um rótulo de coluna em uma caixa cinza)
O para estado (um rótulo de linha em uma caixa cinza)
O evento que causa a transição (uma entrada de tabela em uma caixa branca)

Uma caixa branca em branco indica que nenhuma transição pode ocorrer diretamente do associado do estado para o correspondente para estado. estado de sessão de listagem de tabelas

Na tabela anterior, os de e para estados são representados por constantes de enumeração IO_SESSION_STATE e os eventos são representados por constantes de enumeração IO_SESSION_EVENT. Por exemplo, se o estado da sessão for IoSessionStateConnected (abreviado como "Conectado" na tabela), um evento IoSessionEventLogon (abreviado como "Logon") causará uma transição para o estado IoSessionStateLoggedOn (abreviado como "LoggedOn"). O estado inicial de uma nova sessão é IoSessionStateInitialized (abreviado como "Inicializado").

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no Windows 7 e versões posteriores do sistema operacional Windows.
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)

Consulte também

IO_SESSION_EVENT

IO_SESSION_STATE_INFORMATION

IoGetContainerInformation

Partilhar via