Share via

Método IVdsService::Unadvise (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.]

Cancela o registro da interface IVdsAdviseSink do chamador para que o chamador não receba mais notificações do serviço VDS.

Sintaxe

HRESULT Unadvise(
  [in] DWORD dwCookie
);

Parâmetros

[in] dwCookie

O cookie que foi retornado pelo método IVdsService::Advise quando a interface IVdsAdviseSink foi registrada.

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.

Retornar código/valor Descrição
S_OK
 O método foi concluído com sucesso.
VDS_E_BAD_COOKIE
0x80042411L
 O cookie não existe.
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

Use o método Advise para registrar a interface IVdsAdviseSink do aplicativo VDS para receber notificações do VDS. O aviso retorna um cookie, que você deve passar de volta como um parâmetro para o método Unadvise .

Nota Um aplicativo que chama Advise deve eventualmente chamar Unadvise. O ideal é que ele chame Unadvise assim que não precisar mais receber notificações.
 
O método Unadvise pode não retornar imediatamente, pois aguarda um bloqueio para atualizar a lista de aplicativos cliente registrados e aguarda o thread de notificação que envia as notificações do cliente para sair. Se houver notificações pendentes a serem enviadas ao aplicativo, o thread de notificação tentará enviá-las antes de sair.

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

IVdsAdviseSink

IVdsService

IVdsService::Advise

Notificações do VDS