IoGetContainerInformation-Funktion (wdm.h)

Artikel
02/29/2024

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 von Ereignissen 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 = IoSessionStateInformation diesen Parameter auf den Parameterwert SessionObject fest, der vom E/A-Manager während des Aufrufs der IO_SESSION_NOTIFICATION_FUNCTION-Funktion des Treibers bereitgestellt wird.

[in, out] Buffer

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, in den diese Routine die Zustandsinformationen für die von InformationClass angegebene Ereignisklasse schreibt. Für InformationClass = IoSessionStateInformation schreibt 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 Puffer verweist. Für InformationClass = IoSessionStateInformation muss BufferLength mindestens sizeof(IO_SESSION_STATE_INFORMATION) sein.

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	Parameter InformationClass ist keine gültige IO_CONTAINER_INFORMATION_CLASS Enumerationskonstante.
STATUS_INVALID_PARAMETER_2	Parameter ContainerObject ist NULL.
STATUS_INVALID_PARAMETER_4	Parameter BufferLength ist zu klein für die durch InformationClass angegebene Informationsklasse.

Hinweise

Diese Routine kann möglicherweise Abfragen für eine Vielzahl von Informationsklassen unterstützen. In Windows 7 unterstützt diese Routine nur Abfragen nach IoSessionStateInformation-Informationen, d. h. status Informationen zu Benutzersitzungen.

Anforderungen

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

Weitere Informationen

IO_CONTAINER_INFORMATION_CLASS

IO_CONTAINER_NOTIFICATION_CLASS

IO_SESSION_STATE_INFORMATION

Freigeben über