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 開始使用。
目標平台 Universal
標頭 ntifs.h (包括 Ntifs.h、Fltkernel.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL

另請參閱

UNICODE_STRING