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 |