IoQueryFileDosDeviceName-Funktion (ntifs.h)
Die IoQueryFileDosDeviceName-Routine ruft einen MS-DOS-Gerätenamen für eine Datei ab.
Syntax
NTSTATUS IoQueryFileDosDeviceName(
[in] PFILE_OBJECT FileObject,
[out] POBJECT_NAME_INFORMATION *ObjectNameInformation
);
Parameter
[in] FileObject
Zeiger auf ein Dateiobjekt für die Datei.
[out] ObjectNameInformation
Ein zurückgegebener Zeiger auf eine neu zugeordnete OBJECT_NAME_INFORMATION-Struktur . Diese Struktur wird bei erfolgreicher Rückgabe mit den Informationen zum MS-DOS-Gerätenamen ausgefüllt. Die -Struktur ist wie folgt definiert:
typedef struct _OBJECT_NAME_INFORMATION {
UNICODE_STRING Name;
} OBJECT_NAME_INFORMATION, *POBJECT_NAME_INFORMATION;
Hinweis Diese Struktur muss schließlich durch Aufrufen von ExFreePool freigegeben werden.
Rückgabewert
IoQueryFileDosDeviceName gibt STATUS_SUCCESS oder einen Fehlerwert NTSTATUS zurück, z. B. STATUS_INSUFFICIENT_RESOURCES.
Hinweise
Weitere Informationen zu MS-DOS-Namen finden Sie im Abschnitt Dateien und E/A der Dokumentation zum Platform Software Development Kit (SDK).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Diese Routine ist abWindows XP verfügbar. |
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h, Fltkernel.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |