Fungsi IoGetContainerInformation (wdm.h)
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
[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 |
---|---|
|
Parameter InformationClass bukan konstanta enumerasi IO_CONTAINER_INFORMATION_CLASS yang valid. |
|
Parameter ContainerObject adalah NULL. |
|
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