Método IVdsDisk::QueryExtents (vds.h)

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Retorna os detalhes de todas as extensões em um disco.

Sintaxe

HRESULT QueryExtents(
  [out] VDS_DISK_EXTENT **ppExtentArray,
  [out] LONG            *plNumberOfExtents
);

Parâmetros

[out] ppExtentArray

Uma variável de ponteiro que recebe um
matriz de estruturas VDS_DISK_EXTENT . Os chamadores devem liberar essa matriz usando a função CoTaskMemFree .

[out] plNumberOfExtents

O endereço de um tipo LONG que representa o número total de extensões.

Retornar valor

Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY, e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem se originar do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Comentários

Use esse método para determinar a quantidade de espaço livre disponível para criar ou estender volumes. Você também pode usar as informações de extensão para determinar quantos volumes ocupam o disco. Os tipos de extensão válidos são: extensões desconhecidas, extensões livres, extensões de dados, extensões OEM, extensões ESP, extensões MSR, extensões de metadados LDM e extensões inutilizáveis. Uma extensão de dados contém um link para o volume sobre ele.

Se o disco for um disco dinâmico, ele deverá estar online. Se for um disco básico ou um disco bruto, ele poderá estar online ou offline.

Requisitos

Confira também

IVdsDisk

IVdsDisk::ClearFlags

IVdsDisk::ConvertStyle

IVdsDisk::GetIdentificationData

IVdsDisk::GetPack

IVdsDisk::GetProperties

IVdsDisk::SetFlags

VDS_DISK_EXTENT