Funzione GetVirtualDiskPhysicalPath (virtdisk.h)

Articolo
06/27/2024

Recupera il percorso dell'oggetto dispositivo fisico che contiene un disco rigido virtuale (VHD) o un file di immagine CD o DVD (ISO).

Sintassi

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

Parametri

[in] VirtualDiskHandle

Handle per il disco virtuale aperto, che deve essere stato aperto usando il flag VIRTUAL_DISK_ACCESS_GET_INFO. Per informazioni su come aprire un disco virtuale, vedere la funzione OpenVirtualDisk.

[in, out] DiskPathSizeInBytes

Dimensioni, in byte, del buffer a cui punta il parametro DiskPath.

[out, optional] DiskPath

Buffer di destinazione per ricevere il percorso del dispositivo disco fisico che contiene il disco virtuale.

Valore restituito

Stato della richiesta.

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS e il parametro diskPath contiene un puntatore a una stringa popolata.

Se la funzione ha esito negativo, il valore restituito è un codice di errore e il valore del contenuto del buffer a cui fa riferimento il parametro diskPath non è definito. Per altre informazioni, vedere codici di errore di sistema .

Osservazioni

Affinché la funzione GetVirtualDiskPhysicalPath abbia esito positivo, il disco virtuale a cui fa riferimento il parametro VirtualDiskHandle deve essere collegato, l'oggetto disco fisico deve trovarsi nel sistema e il parametro DiskPath deve fare riferimento a un buffer sufficientemente grande da contenere il percorso risultante. Questo percorso è nel formato \\.\PhysicalDriveX dove X è un numero intero che rappresenta l'enumerazione specifica del disco fisico nel sistema del chiamante.

I file di immagine CD e DVD (ISO) non sono supportati prima di Windows 8 e Windows Server 2012.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7
server minimo supportato	Windows Server 2008 R2
piattaforma di destinazione	Finestre
intestazione	virtdisk.h
libreria	VirtDisk.lib
dll	VirtDisk.dll

Vedere anche

Informazioni sul del disco rigido virtuale

di riferimento del disco rigido virtuale

Condividi tramite