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 (Ntifs.h、Fltkernel.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL