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 一節。