Funzione IoGetContainerInformation (wdm.h)

Articolo
08/08/2023

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 ulteriori informazioni, vedere la sezione Osservazioni successiva.

[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 dalla gestione I/O durante la chiamata alla funzione di 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 abbastanza grande per contenere questa struttura.

[in] BufferLength

Dimensioni, in byte, del buffer a cui punta il buffer. Per InformationClass = IoSessionStateInformation, BufferLength deve essere almeno sizeof(IO_SESSION_STATE_INFORMATION).

Valore restituito

IoGetContainerInformation restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti degli errori possibili includono quanto segue:

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

Commenti

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

Requisiti

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

Vedi anche

IO_CONTAINER_INFORMATION_CLASS

IO_CONTAINER_NOTIFICATION_CLASS

IO_SESSION_STATE_INFORMATION

Condividi tramite