GetVirtualDiskPhysicalPath-Funktion (virtdisk.h)

Ruft den Pfad zum physischen Geräteobjekt ab, das eine virtuelle Festplatte (VHD) oder eine CD- oder DVD-Imagedatei (ISO) enthält.

Syntax

DWORD GetVirtualDiskPhysicalPath(
  [in]            HANDLE VirtualDiskHandle,
  [in, out]       PULONG DiskPathSizeInBytes,
  [out, optional] PWSTR  DiskPath
);

Parameter

[in] VirtualDiskHandle

Ein Handle für den geöffneten virtuellen Datenträger, der mit dem VIRTUAL_DISK_ACCESS_GET_INFO-Flag geöffnet worden sein muss. Informationen zum Öffnen eines virtuellen Datenträgers finden Sie in der OpenVirtualDisk-Funktion .

[in, out] DiskPathSizeInBytes

Die Größe des Puffers in Bytes, auf den der DiskPath-Parameter verweist.

[out, optional] DiskPath

Ein Zielpuffer, um den Pfad des physischen Datenträgergeräts zu empfangen, das den virtuellen Datenträger enthält.

Rückgabewert

Status der Anforderung.

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS und der DiskPath-Parameter enthält einen Zeiger auf eine aufgefüllte Zeichenfolge.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode, und der Wert des Inhalts des Puffers, auf den vom DiskPath-Parameter verwiesen wird, ist nicht definiert. Weitere Informationen finden Sie unter Systemfehlercodes.

Hinweise

Damit die GetVirtualDiskPhysicalPath-Funktion erfolgreich ist, muss der virtuelle Datenträger, auf den vom VirtualDiskHandle-Parameter verwiesen wird, angefügt werden, das physische Datenträgerobjekt muss vom System gefunden werden, und der DiskPath-Parameter muss auf einen Puffer verweisen, der groß genug ist, um den resultierenden Pfad zu speichern. Dieser Pfad hat das Format \.\PhysicalDriveX , wobei X eine ganze Zahl ist, die die bestimmte Enumeration des physischen Datenträgers auf dem System des Aufrufers darstellt.

CD- und DVD-Imagedateien (ISO) werden vor Windows 8 und Windows Server 2012 nicht unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Zielplattform	Windows
Kopfzeile	virtdisk.h
Bibliothek	VirtDisk.lib
DLL	VirtDisk.dll

Weitere Informationen

Informationen zu VHD

VHD-Referenz