Función IoGetContainerInformation (wdm.h)

La rutina IoGetContainerInformation proporciona información sobre el estado actual de una sesión de usuario.

Sintaxis

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

Parámetros

[in] InformationClass

Especifica la clase de eventos para los que el autor de la llamada (controlador) solicita información. Establezca este parámetro en el siguiente valor de enumeración IO_CONTAINER_INFORMATION_CLASS :

• IoSessionStateInformation

Para obtener más información, vea la sección Comentarios que se muestra más adelante.

[in, optional] ContainerObject

Puntero a un objeto de sistema opaco proporcionado por el administrador de E/S. Para InformationClass = IoSessionStateInformation, establezca este parámetro en el valor del parámetro SessionObject proporcionado por el administrador de E/S durante la llamada a la función de IO_SESSION_NOTIFICATION_FUNCTION del controlador.

[in, out] Buffer

Puntero a un búfer asignado por el autor de la llamada en el que esta rutina escribe la información de estado de la clase de eventos especificada por InformationClass. Para InformationClass = IoSessionStateInformation, la rutina escribe una estructura de IO_SESSION_STATE_INFORMATION en el búfer. El búfer debe ser lo suficientemente grande como para contener esta estructura.

[in] BufferLength

Tamaño, en bytes, del búfer al que apunta buffer. Para InformationClass = IoSessionStateInformation, BufferLength debe ser al menos sizeof(IO_SESSION_STATE_INFORMATION).

Valor devuelto

IoGetContainerInformation devuelve STATUS_SUCCESS si la llamada es correcta. Entre los valores devueltos de error posibles se incluyen los siguientes:

Código devuelto	Descripción
STATUS_INVALID_PARAMETER_1	Parameter InformationClass no es una constante de enumeración IO_CONTAINER_INFORMATION_CLASS válida.
STATUS_INVALID_PARAMETER_2	El parámetro ContainerObject es NULL.
STATUS_INVALID_PARAMETER_4	El parámetro BufferLength es demasiado pequeño para la clase de información especificada por InformationClass.

Comentarios

Esta rutina puede admitir consultas para una variedad de clases de información. En Windows 7, esta rutina solo admite consultas para la información de IoSessionStateInformation , que es información de estado sobre las sesiones de usuario.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 7 y versiones posteriores del sistema operativo Windows.
Plataforma de destino	Universal
Encabezado	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte también

IO_CONTAINER_INFORMATION_CLASS

IO_CONTAINER_NOTIFICATION_CLASS

IO_SESSION_STATE_INFORMATION