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
Zeigen Sie 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 wird 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 ExFreePool-freigegeben werden.
Rückgabewert
IoQueryFileDosDeviceName gibt STATUS_SUCCESS oder einen Fehler NTSTATUS-Wert zurück, z. B. STATUS_INSUFFICIENT_RESOURCES.
Bemerkungen
Weitere Informationen zu MS-DOS Namen finden Sie im Abschnitt "Dateien und E/A" der Dokumentation zu Platform Software Development Kit (SDK).
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Diese Routine ist abWindows XP verfügbar. |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h, Fltkernel.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | PASSIVE_LEVEL |