Método IVdsVolumeShrink::QueryMaxReclaimableBytes (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.]
Recupera o número máximo de bytes que podem ser recuperados do volume atual.
Sintaxe
HRESULT QueryMaxReclaimableBytes(
[out] ULONGLONG *pullMaxNumberOfReclaimableBytes
);
Parâmetros
[out] pullMaxNumberOfReclaimableBytes
Ponteiro para uma variável que, após a conclusão bem-sucedida, recebe o número máximo de bytes que podem ser recuperados do volume atual. Esse número sempre será um múltiplo do tamanho do cluster do sistema de arquivos, que, por sua vez, é um múltiplo do tamanho do setor de disco. Esse parâmetro é necessário e não pode ser nulo.
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 ser originados 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 |
|---|---|
|
O método foi concluído com sucesso. |
|
O volume não pode ser reduzido porque o sistema de arquivos não dá suporte a ele. |
|
Não há suporte para a operação em mídia removível. |
|
O parâmetro pullMaxNumberOfReclaimableBytes era nulo na entrada. |
Comentários
Esse método pode retornar bytes mais recuperáveis do que realmente estão disponíveis.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vds.h |
| Biblioteca | Uuid.lib |