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 mithilfe des VIRTUAL_DISK_ACCESS_GET_INFO-Flags geöffnet werden muss. Informationen zum Öffnen eines virtuellen Datenträgers finden Sie in der funktion OpenVirtualDisk.

[in, out] DiskPathSizeInBytes

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

[out, optional] DiskPath

Ein Zielpuffer, der den Pfad des physischen Datenträgergeräts empfängt, 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 parameter DiskPath 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 der DiskPath-Parameter verweist, ist nicht definiert. Weitere Informationen finden Sie unter Systemfehlercodes.

Bemerkungen

Damit die GetVirtualDiskPhysicalPath--Funktion erfolgreich ausgeführt werden kann, muss der virtuelle Datenträger, auf den der VirtualDiskHandle- Parameter verweist, angefügt werden muss, das physische Datenträgerobjekt muss sich im System befinden, und der parameter DiskPath muss auf einen Puffer verweisen, der groß genug ist, um den resultierenden Pfad zu speichern. Dieser Pfad befindet sich in form \\.\PhysicalDriveX- wobei X- eine ganze Zahl ist, die die bestimmte Enumeration des physischen Datenträgers im System des Aufrufers darstellt.

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

Anforderungen

Siehe auch

zu VHD-

VHD-Referenz-