IoGetContainerInformation-Funktion (wdm.h)

Artikel
02/07/2025

Die IoGetContainerInformation Routine stellt Informationen zum aktuellen Zustand einer Benutzersitzung bereit.

Syntax

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

Parameter

[in] InformationClass

Gibt die Klasse der Ereignisse an, für die der Aufrufer (Treiber) Informationen anfordert. Legen Sie diesen Parameter auf den folgenden IO_CONTAINER_INFORMATION_CLASS Enumerationswert fest:

IoSessionStateInformation

Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[in, optional] ContainerObject

Ein Zeiger auf ein undurchsichtiges Systemobjekt, das vom E/A-Manager bereitgestellt wird. Legen Sie für InformationClass = IoSessionStateInformationdiesen Parameter auf den SessionObject Parameterwert fest, der während des Aufrufs der IO_SESSION_NOTIFICATION_FUNCTION-Funktion des Treibers vom E/A-Manager bereitgestellt wird.

[in, out] Buffer

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, in den diese Routine die Statusinformationen für die durch InformationClassangegebene Ereignisklasse schreibt. Für InformationClass = IoSessionStateInformationschreibt die Routine eine IO_SESSION_STATE_INFORMATION Struktur in den Puffer. Der Puffer muss groß genug sein, um diese Struktur zu enthalten.

[in] BufferLength

Die Größe des Puffers in Bytes, auf den Bufferverweist. Für InformationClass = IoSessionStateInformation muss BufferLength- mindestens Größe(IO_SESSION_STATE_INFORMATION) aufweisen.

Rückgabewert

IoGetContainerInformation gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Mögliche Fehlerrückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER_1	Der Parameter InformationClass- ist keine gültige IO_CONTAINER_INFORMATION_CLASS Enumerationskonstante.
STATUS_INVALID_PARAMETER_2	Der Parameter ContainerObject- ist NULL-.
STATUS_INVALID_PARAMETER_4	Der Parameter BufferLength- ist für die durch InformationClassangegebene Informationsklasse zu klein.

Bemerkungen

Diese Routine kann Abfragen für eine Vielzahl von Informationsklassen potenziell unterstützen. In Windows 7 unterstützt diese Routine nur Abfragen für IoSessionStateInformation Informationen, die Statusinformationen zu Benutzersitzungen sind.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 7 und höheren Versionen des Windows-Betriebssystems.
Zielplattform-	Universal
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL

Siehe auch

IO_CONTAINER_INFORMATION_CLASS

IO_CONTAINER_NOTIFICATION_CLASS

IO_SESSION_STATE_INFORMATION

Freigeben über