Método IVdsHwProviderStoragePools::QueryStoragePools (vdshwprv.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 um objeto de enumeração IEnumVdsObject que contém uma lista dos pools de armazenamento gerenciados pelo provedor de hardware.

Sintaxe

HRESULT QueryStoragePools(
  [in]  ULONG               ulFlags,
  [in]  ULONGLONG           ullRemainingFreeSpace,
  [in]  VDS_POOL_ATTRIBUTES *pPoolAttributes,
  [out] IEnumVdsObject      **ppEnum
);

Parâmetros

[in] ulFlags

Uma máscara de bits de um ou mais sinalizadores de VDS_STORAGE_POOL_TYPE que especificam os tipos de pools de armazenamento a serem consultados. Um dos sinalizadores deve ser VDS_SPT_CONCRETE ou VDS_SPT_PRIMORDIAL. O valor padrão desse parâmetro é zero. Um valor zero significa que todos os pools de armazenamento devem ser consultados.

[in] ullRemainingFreeSpace

A quantidade mínima de espaço livre, em bytes, que cada pool de armazenamento deve conter. O valor padrão para esse parâmetro é zero. Um valor zero significa que os pools de armazenamento podem conter qualquer quantidade de espaço livre.

[in] pPoolAttributes

Um ponteiro para uma estrutura VDS_POOL_ATTRIBUTES que especifica os valores de atributo que os pools de armazenamento retornados devem ter. O valor padrão para esse parâmetro é NULL. Um valor nulo significa que os pools de armazenamento podem ter qualquer valor de atributo.

[out] ppEnum

O endereço de um ponteiro de interface IEnumVdsObject que pode ser usado para enumerar os pools de armazenamento. Para obter mais informações, consulte Trabalhando com objetos de enumeração. Os chamadores devem liberar a interface e cada um dos objetos do pool de armazenamento quando eles não forem mais necessários chamando o método IUnknown::Release . Esse parâmetro é necessário e não pode ser NULL.

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	O método foi concluído com sucesso.

Comentários

Se o provedor de hardware não gerenciar nenhum pool de armazenamento, esse método retornará um objeto de enumeração vazio.

Se um valor não NULL for especificado no parâmetro pPoolAttributes , esse método retornará apenas pools de armazenamento que atendem a todos os atributos especificados na estrutura VDS_POOL_ATTRIBUTES . Se algum atributo mínimo e máximo for especificado, os pools de armazenamento retornados deverão corresponder exatamente a esses atributos. Os atributos de dica são usados como dicas para filtrar ainda mais os pools de armazenamento que atendem a todos os atributos especificados. Se um atributo especificado não se aplicar a nenhum dos pools de armazenamento, esse método retornará S_OK com um objeto de enumeração vazio.

Requisitos

Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	vdshwprv.h
Biblioteca	Uuid.lib

Confira também

IVdsHwProviderStoragePools