Compartilhar via

Método IVdsService::Refresh (vds.h)

  • Artigo

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

Atualiza as informações de propriedade de disco e layout de disco.

Sintaxe

HRESULT Refresh();

Retornar valor

Esse método pode retornar valores HRESULT padrão, como 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.

Código/valor de retorno Descrição
S_OK
 O método foi concluído com sucesso.
S_FALSE
 Ocorreu um erro durante esta operação.
VDS_E_INITIALIZED_FAILED
0x80042401L
 Falha ao inicializar o VDS. Se um aplicativo chamar esse método antes que o serviço termine de inicializar, o método será bloqueado até que a inicialização seja concluída. Se a inicialização falhar, esse erro será retornado.

Comentários

Esse método sincroniza o layout do disco com o layout conhecido pelo driver de disco. Ele não força o driver a ler o layout do disco. Além disso, esse método atualiza a exibição de todos os objetos no cache do VDS. O VDS e os provedores consultam todos os objetos, enviando notificações de chegada, modificação e remoção de objetos para sincronizar o chamador. Observe que o VDS atualiza o cache automaticamente sempre que detecta uma alteração que dispara uma notificação. Por esse motivo, e como chamar Refresh pode disparar notificações adicionais, os aplicativos não devem chamar esse método em resposta às notificações. A atualização deve ser chamada somente quando aparecer que o cache não está sendo atualizado corretamente.

Requisitos

   
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

IVdsService