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

Artigo
03/13/2024

[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.

Valor/código retornado	Descrição
S_OK	As informações de extensão foram retornadas com êxito.
VDS_E_PACK_OFFLINE 0x80042444L	O pacote ao qual o disco pertence está inacessível.

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

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	vds.h
Biblioteca	Uuid.lib