Fungsi IoQueryFileDosDeviceName (ntifs.h)
Rutinitas IoQueryFileDosDeviceName mengambil nama perangkat MS-DOS untuk file.
Sintaks
NTSTATUS IoQueryFileDosDeviceName(
[in] PFILE_OBJECT FileObject,
[out] POBJECT_NAME_INFORMATION *ObjectNameInformation
);
Parameter
[in] FileObject
Penunjuk ke objek file untuk file.
[out] ObjectNameInformation
Penunjuk yang dikembalikan ke struktur OBJECT_NAME_INFORMATION yang baru dialokasikan. Struktur ini diisi pada pengembalian yang berhasil dengan informasi nama perangkat MS-DOS. Struktur didefinisikan sebagai berikut:
typedef struct _OBJECT_NAME_INFORMATION {
UNICODE_STRING Name;
} OBJECT_NAME_INFORMATION, *POBJECT_NAME_INFORMATION;
Catatan Struktur ini akhirnya harus dibebaskan dengan memanggil ExFreePool.
Mengembalikan nilai
IoQueryFileDosDeviceName mengembalikan nilai STATUS_SUCCESS atau kesalahan NTSTATUS, seperti STATUS_INSUFFICIENT_RESOURCES.
Keterangan
Untuk informasi selengkapnya tentang nama MS-DOS, lihat bagian File dan I/O dari dokumentasi Platform Software Development Kit (SDK).
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Rutinitas ini tersedia dimulai denganWindows XP. |
| Target Platform | Universal |
| Header | ntifs.h (termasuk Ntifs.h, Fltkernel.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |