Função GetVirtualDiskPhysicalPath (virtdisk.h)

Artigo
06/27/2024

Recupera o caminho para o objeto de dispositivo físico que contém um VHD (disco rígido virtual) ou um ISO (arquivo de imagem de CD ou DVD).

Sintaxe

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

Parâmetros

[in] VirtualDiskHandle

Um identificador para o disco virtual aberto, que deve ter sido aberto usando o sinalizador VIRTUAL_DISK_ACCESS_GET_INFO. Para obter informações sobre como abrir um disco virtual, consulte a função OpenVirtualDisk.

[in, out] DiskPathSizeInBytes

O tamanho, em bytes, do buffer apontado pelo parâmetro DiskPath.

[out, optional] DiskPath

Um buffer de destino para receber o caminho do dispositivo de disco físico que contém o disco virtual.

Valor de retorno

Status da solicitação.

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS e o parâmetro DiskPath conterá um ponteiro para uma cadeia de caracteres preenchida.

Se a função falhar, o valor retornado será um código de erro e o valor do conteúdo do buffer referenciado pelo parâmetro DiskPath será indefinido. Para obter mais informações, consulte códigos de erro do sistema.

Observações

Para que a função GetVirtualDiskPhysicalPath seja bem-sucedida, o disco virtual referenciado pelo parâmetro VirtualDiskHandle deve ser anexado, o objeto de disco físico deve estar localizado pelo sistema e o parâmetro DiskPath deve se referir a um buffer grande o suficiente para manter o caminho resultante. Esse caminho está no formulário \\.\ PhysicalDriveX em que X é um inteiro que representa a enumeração específica do disco físico no sistema do chamador.

Não há suporte para ISO (arquivos de imagem de CD e DVD) antes do Windows 8 e do Windows Server 2012.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 7
servidor com suporte mínimo	Windows Server 2008 R2
da Plataforma de Destino	Windows
cabeçalho	virtdisk.h
biblioteca	VirtDisk.lib
de DLL	VirtDisk.dll

Consulte também

sobre VHD

de referência de VHD

Compartilhar via