Fonction IoGetContainerInformation (wdm.h)

Article
02/07/2025

La routine IoGetContainerInformation fournit des informations sur l’état actuel d’une session utilisateur.

Syntaxe

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

Paramètres

[in] InformationClass

Spécifie la classe d’événements pour laquelle l’appelant (pilote) demande des informations. Définissez ce paramètre sur la valeur d’énumération IO_CONTAINER_INFORMATION_CLASS suivante :

ioSessionStateInformation

Pour plus d’informations, consultez la section Remarques suivante.

[in, optional] ContainerObject

Pointeur vers un objet système opaque fourni par le gestionnaire d’E/S. Pour InformationClass = IoSessionStateInformation, définissez ce paramètre sur la valeur de paramètre SessionObject fournie par le gestionnaire d’E/S pendant l’appel à la fonction IO_SESSION_NOTIFICATION_FUNCTION du pilote.

[in, out] Buffer

Pointeur vers une mémoire tampon allouée par l’appelant dans laquelle cette routine écrit les informations d’état de la classe d’événements spécifiée par InformationClass. Pour InformationClass = IoSessionStateInformation, la routine écrit une structure IO_SESSION_STATE_INFORMATION dans la mémoire tampon. La mémoire tampon doit être suffisamment grande pour contenir cette structure.

[in] BufferLength

Taille, en octets, de la mémoire tampon pointée par tampon. Pour InformationClass = IoSessionStateInformation, BufferLength doit être au moins taille de(IO_SESSION_STATE_INFORMATION).

Valeur de retour

IoGetContainerInformation retourne STATUS_SUCCESS si l’appel réussit. Les valeurs de retour d’erreur possibles sont les suivantes :

Retourner le code	Description
STATUS_INVALID_PARAMETER_1	Le paramètre InformationClass n’est pas une constante d’énumération IO_CONTAINER_INFORMATION_CLASS valide.
STATUS_INVALID_PARAMETER_2	Le paramètre ContainerObject est NULL.
STATUS_INVALID_PARAMETER_4	Le paramètre bufferLength est trop petit pour la classe d’informations spécifiée par InformationClass.

Remarques

Cette routine peut potentiellement prendre en charge les requêtes pour diverses classes d’informations. Dans Windows 7, cette routine prend uniquement en charge les requêtes pour Informations IoSessionStateInformation, qui sont des informations d’état sur les sessions utilisateur.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows 7 et versions ultérieures du système d’exploitation Windows.
plateforme cible	Universel
d’en-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Voir aussi

IO_CONTAINER_INFORMATION_CLASS

IO_CONTAINER_NOTIFICATION_CLASS

IO_SESSION_STATE_INFORMATION

Partager via