Функция IoGetContainerInformation (wdm.h)

Статья
02/07/2025

Подпрограмма IoGetContainerInformation предоставляет сведения о текущем состоянии сеанса пользователя.

Синтаксис

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

Параметры

[in] InformationClass

Указывает класс событий, для которых вызывающий (драйвер) запрашивает сведения. Задайте для этого параметра следующее значение перечисления IO_CONTAINER_INFORMATION_CLASS:

IoSessionStateInformation

Дополнительные сведения см. в следующем разделе "Примечания".

[in, optional] ContainerObject

Указатель на непрозрачный системный объект, предоставленный диспетчером ввода-вывода. Для InformationClass = IoSessionStateInformationзадайте для этого параметра значение параметра SessionObject, предоставленное диспетчером операций ввода-вывода во время вызова функции IO_SESSION_NOTIFICATION_FUNCTION драйвера.

[in, out] Buffer

Указатель на выделенный вызывающим буфером, в который эта подпрограмма записывает сведения о состоянии для класса событий, указанного InformationClass. Для InformationClass = IoSessionStateInformationподпрограмма записывает структуру IO_SESSION_STATE_INFORMATION в буфер. Буфер должен быть достаточно большим, чтобы содержать эту структуру.

[in] BufferLength

Размер буфера в байтах, на который указывает буфер. Для InformationClass = IoSessionStateInformation bufferLength должен быть по крайней мере размер(IO_SESSION_STATE_INFORMATION).

Возвращаемое значение

IoGetContainerInformation возвращает STATUS_SUCCESS, если вызов выполнен успешно. Возможные значения возвращаемых ошибок включают следующие значения:

Возвращаемый код	Описание
STATUS_INVALID_PARAMETER_1	Параметр InformationClass не является допустимой константой перечисления IO_CONTAINER_INFORMATION_CLASS.
STATUS_INVALID_PARAMETER_2	Параметр ContainerObjectNULL.
STATUS_INVALID_PARAMETER_4	Параметр BufferLength слишком мал для класса информации, указанного InformationClass.

Замечания

Эта подпрограмма может поддерживать запросы для различных классов информации. В Windows 7 эта подпрограмма поддерживает только запросы IoSessionStateInformation сведения о состоянии сеансов пользователей.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 7 и более поздних версиях операционной системы Windows.
целевая платформа	Всеобщий
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также

IO_CONTAINER_INFORMATION_CLASS

IO_CONTAINER_NOTIFICATION_CLASS

IO_SESSION_STATE_INFORMATION

Поделиться через