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 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h、Fltkernel.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL