RtlVolumeDeviceToDosName-Funktion (ntddk.h)

Artikel
02/07/2025

Die RtlVolumeDeviceToDosName Routine ist veraltete für Windows XP und neuere Versionen von Windows. Verwenden Sie stattdessen IoVolumeDeviceToDosName.

RtlVolumeDeviceToDosName gibt den MS-DOS Pfad für ein angegebenes Geräteobjekt zurück, das ein Dateisystemvolume darstellt.

Syntax

NTSYSAPI NTSTATUS RtlVolumeDeviceToDosName(
  [in]  PVOID           VolumeDeviceObject,
  [out] PUNICODE_STRING DosName
);

Parameter

[in] VolumeDeviceObject

Zeiger auf ein Geräteobjekt, das ein Volumegerätobjekt darstellt, das von einem Speicherklassentreiber erstellt wurde.

[out] DosName

Zeiger auf eine Unicode-Zeichenfolge, die den MS-DOS Pfad des Volumegeräteobjekts enthält, das durch VolumeDeviceObjectangegeben wird.

Rückgabewert

RtlVolumeDeviceToDosName gibt STATUS_SUCCESS oder einen entsprechenden Fehlerstatus zurück.

Bemerkungen

Das Verhalten dieser Routine ist identisch mit dem von IoVolumeDeviceToDosName. Weitere Informationen zur Verwendung dieser Routine finden Sie unter IoVolumeDeviceToDosName.

Treiber, die auf älteren NT-basierten Betriebssystemen funktionieren müssen, können diese Routine verwenden. Für Windows XP und höher geschriebene Treiber müssen stattdessen IoVolumeDeviceToDosName- verwenden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Veraltet für Microsoft Windows XP und höhere Versionen von Windows. Verwenden Sie stattdessen IoVolumeDeviceToDosName.
Zielplattform-	Universal
Header-	ntddk.h (include Ntddk.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe

Freigeben über