Compartilhar via


Método IVdsAdvancedDisk::QueryPartitions (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 partições no disco atual.

Sintaxe

HRESULT QueryPartitions(
  [out] VDS_PARTITION_PROP **ppPartitionPropArray,
  [out] LONG               *plNumberOfPartitions
);

Parâmetros

[out] ppPartitionPropArray

Um ponteiro para a matriz de VDS_PARTITION_PROP estruturas passadas pelo chamador. Os chamadores devem liberar essa matriz usando a função CoTaskMemFree .

[out] plNumberOfPartitions

Um ponteiro para o número de elementos na matriz retornada no parâmetro ppPartitionPropArray .

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.

Código de retorno Descrição
S_OK
A consulta foi bem-sucedida.
S_FALSE
O disco não contém partições.

Comentários

Se o disco contiver partições estendidas, esse método retornará apenas a primeira partição estendida, independentemente de quantas partições estendidas estão no disco. Um disco contém uma partição estendida para cada unidade lógica. Para obter mais informações sobre unidades lógicas, consulte Objeto disk.

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

Confira também

Objeto Disk

IVdsAdvancedDisk

VDS_PARTITION_PROP