Funzione IoGetContainerInformation (wdm.h)

Articolo
02/07/2025

La routine IoGetContainerInformation fornisce informazioni sullo stato corrente di una sessione utente.

Sintassi

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

Parametri

[in] InformationClass

Specifica la classe di eventi per cui il chiamante (driver) richiede informazioni. Impostare questo parametro sul valore di enumerazione IO_CONTAINER_INFORMATION_CLASS seguente:

IoSessionStateInformation

Per altre informazioni, vedere la sezione Osservazioni seguente.

[in, optional] ContainerObject

Puntatore a un oggetto di sistema opaco fornito dal gestore di I/O. Per InformationClass = IoSessionStateInformation, impostare questo parametro sul valore del parametro SessionObject fornito dal gestore di I/O durante la chiamata alla funzione IO_SESSION_NOTIFICATION_FUNCTION del driver.

[in, out] Buffer

Puntatore a un buffer allocato dal chiamante in cui questa routine scrive le informazioni sullo stato per la classe di evento specificata da InformationClass. Per InformationClass = IoSessionStateInformation, la routine scrive una struttura IO_SESSION_STATE_INFORMATION nel buffer. Il buffer deve essere sufficientemente grande da contenere questa struttura.

[in] BufferLength

Dimensione, in byte, del buffer a cui punta Buffer. Per InformationClass = IoSessionStateInformation, BufferLength deve essere almeno dimensione di(IO_SESSION_STATE_INFORMATION).

Valore restituito

IoGetContainerInformation restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I possibili valori restituiti dall'errore includono quanto segue:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER_1	Il parametro InformationClass non è una costante di enumerazione IO_CONTAINER_INFORMATION_CLASS valida.
STATUS_INVALID_PARAMETER_2	Il parametro ContainerObject è NULL.
STATUS_INVALID_PARAMETER_4	Il parametro bufferLength è troppo piccolo per la classe di informazioni specificata da InformationClass.

Osservazioni

Questa routine può potenzialmente supportare query per un'ampia gamma di classi di informazioni. In Windows 7 questa routine supporta solo le query per informazioni di IoSessionStateInformation, ovvero informazioni sullo stato relative alle sessioni utente.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows 7 e versioni successive del sistema operativo Windows.
piattaforma di destinazione	Universale
intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	<= APC_LEVEL

Vedere anche

IO_CONTAINER_INFORMATION_CLASS

IO_CONTAINER_NOTIFICATION_CLASS

IO_SESSION_STATE_INFORMATION

Condividi tramite