Função IoGetContainerInformation (wdm.h)

Artigo
02/07/2025

A rotina de IoGetContainerInformation fornece informações sobre o estado atual de uma sessão de usuário.

Sintaxe

NTSTATUS IoGetContainerInformation(
  [in]           IO_CONTAINER_INFORMATION_CLASS InformationClass,
  [in, optional] PVOID                          ContainerObject,
  [in, out]      PVOID                          Buffer,
  [in]           ULONG                          BufferLength
);

Parâmetros

[in] InformationClass

Especifica a classe de eventos para a qual o chamador (driver) solicita informações. Defina esse parâmetro para o seguinte valor de enumeração IO_CONTAINER_INFORMATION_CLASS:

IoSessionStateInformation

Para obter mais informações, consulte a seção Comentários a seguir.

[in, optional] ContainerObject

Um ponteiro para um objeto opaco do sistema fornecido pelo gerente de E/S. Para = IoSessionStateInformation, defina esse parâmetro como o valor do parâmetro SessionObject fornecido pelo gerenciador de E/S durante a chamada para a função de IO_SESSION_NOTIFICATION_FUNCTION do driver.

[in, out] Buffer

Um ponteiro para um buffer alocado por chamador no qual essa rotina grava as informações de estado da classe de evento especificada por InformationClass. Para InformationClass = IoSessionStateInformation, a rotina grava uma estrutura de IO_SESSION_STATE_INFORMATION no buffer. O buffer deve ser grande o suficiente para conter essa estrutura.

[in] BufferLength

O tamanho, em bytes, do buffer apontado por buffer. Para InformationClass = IoSessionStateInformation, BufferLength deve ter pelo menos tamanho de(IO_SESSION_STATE_INFORMATION).

Valor de retorno

IoGetContainerInformation retornará STATUS_SUCCESS se a chamada for bem-sucedida. Os valores de retorno de erro possíveis incluem o seguinte:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER_1	O InformationClass de parâmetros não é uma constante de enumeração de IO_CONTAINER_INFORMATION_CLASS válida.
STATUS_INVALID_PARAMETER_2	O parâmetro ContainerObject é NULL.
STATUS_INVALID_PARAMETER_4	O parâmetro BufferLength é muito pequeno para a classe de informações especificada por InformationClass.

Observações

Essa rotina pode potencialmente dar suporte a consultas para uma variedade de classes de informações. No Windows 7, essa rotina dá suporte apenas a consultas para informações de IoSessionStateInformation, que são informações de status sobre sessões de usuário.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 7 e versões posteriores do sistema operacional Windows.
da Plataforma de Destino	Universal
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte também

IO_CONTAINER_INFORMATION_CLASS

IO_CONTAINER_NOTIFICATION_CLASS

IO_SESSION_STATE_INFORMATION

Compartilhar via