Fungsi IoQueryFileDosDeviceName (ntifs.h)

  • Artikel

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

Lihat juga

UNICODE_STRING