IoQueryFileDosDeviceName 函式（ntifs.h）

IoQueryFileDosDeviceName 例程會擷取檔案的 MS-DOS 裝置名稱。

語法

NTSTATUS IoQueryFileDosDeviceName(
  [in]  PFILE_OBJECT             FileObject,
  [out] POBJECT_NAME_INFORMATION *ObjectNameInformation
);

[in] FileObject

檔案物件的指標。

[out] ObjectNameInformation

傳回給新配置之 OBJECT_NAME_INFORMATION 結構的指標。此結構會在成功傳回時填入 MS-DOS 裝置名稱資訊。結構的定義如下：

typedef struct _OBJECT_NAME_INFORMATION {
    UNICODE_STRING Name;
} OBJECT_NAME_INFORMATION, *POBJECT_NAME_INFORMATION;

附注此結構最終必須藉由呼叫 exFreePool 釋放。

IoQueryFileDosDeviceName 會傳回STATUS_SUCCESS或錯誤 NTSTATUS 值，例如STATUS_INSUFFICIENT_RESOURCES。

如需 MS-DOS 名稱的詳細資訊，請參閱平臺軟體開發工具包（SDK）檔的檔案和 I/O 一節。

要求	價值
最低支援的用戶端	從 Windows XP 開始，即可使用此例程。
目標平臺	普遍
標頭	ntifs.h （include Ntifs.h， Fltkernel.h）
連結庫	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL