Función IoGetContainerInformation (wdm.h)

  • Artículo

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