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 siguiente sección Comentarios.

[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 de parámetro sessionObject proporcionado por el administrador de E/S durante la llamada a la función 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 Búfer. Para InformationClass = IoSessionStateInformation, bufferLength debe tener al menos tamaño de(IO_SESSION_STATE_INFORMATION).

Valor devuelto

ioGetContainerInformation devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Entre los valores devueltos de error posibles se incluyen los siguientes:

Código devuelto	Descripción
STATUS_INVALID_PARAMETER_1	El parámetro 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.

Observaciones

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

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows 7 y versiones posteriores del sistema operativo Windows.
de la plataforma de destino de	Universal
encabezado de	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	<= APC_LEVEL

Consulte también

IO_CONTAINER_INFORMATION_CLASS

IO_CONTAINER_NOTIFICATION_CLASS

IO_SESSION_STATE_INFORMATION