Fungsi IoGetContainerInformation (wdm.h)

  • Artikel

Rutinitas IoGetContainerInformation menyediakan informasi tentang status sesi pengguna saat ini.

Sintaks

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

Parameter

[in] InformationClass

Menentukan kelas peristiwa tempat pemanggil (driver) meminta informasi. Atur parameter ini ke nilai enumerasi IO_CONTAINER_INFORMATION_CLASS berikut:

  • IoSessionStateInformation
Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

[in, optional] ContainerObject

Penunjuk ke objek sistem buram yang disediakan oleh manajer I/O. Untuk InformationClass = IoSessionStateInformation, atur parameter ini ke nilai parameter SessionObject yang disediakan oleh manajer I/O selama panggilan ke fungsi IO_SESSION_NOTIFICATION_FUNCTION driver.

[in, out] Buffer

Penunjuk ke buffer yang dialokasikan penelepon tempat rutin ini menulis informasi status untuk kelas peristiwa yang ditentukan oleh InformationClass. Untuk InformationClass = IoSessionStateInformation, rutin menulis struktur IO_SESSION_STATE_INFORMATION ke buffer. Buffer harus cukup besar untuk memuat struktur ini.

[in] BufferLength

Ukuran, dalam byte, dari buffer yang ditujukkan oleh Buffer. Untuk InformationClass = IoSessionStateInformation, BufferLength harus setidaknya sizeof(IO_SESSION_STATE_INFORMATION).

Nilai kembali

IoGetContainerInformation mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan meliputi yang berikut ini:

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER_1
 Parameter InformationClass bukan konstanta enumerasi IO_CONTAINER_INFORMATION_CLASS yang valid.
STATUS_INVALID_PARAMETER_2
 Parameter ContainerObject adalah NULL.
STATUS_INVALID_PARAMETER_4
 Parameter BufferLength terlalu kecil untuk kelas informasi yang ditentukan oleh InformationClass.

Keterangan

Rutinitas ini berpotensi mendukung kueri untuk berbagai kelas informasi. Di Windows 7, rutinitas ini hanya mendukung kueri untuk informasi IoSessionStateInformation , yang merupakan informasi status tentang sesi pengguna.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows 7 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Lihat juga

IO_CONTAINER_INFORMATION_CLASS

IO_CONTAINER_NOTIFICATION_CLASS

IO_SESSION_STATE_INFORMATION