Compartir a través de

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

  • Artículo

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Anula el registro de la interfaz IVdsAdviseSink del autor de la llamada para que el autor de la llamada ya no reciba notificaciones del servicio VDS.

Sintaxis

HRESULT Unadvise(
  [in] DWORD dwCookie
);

Parámetros

[in] dwCookie

Cookie devuelta por el método IVdsService::Advise cuando se registró la interfaz IVdsAdviseSink .

Valor devuelto

Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores pueden originarse en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los valores devueltos posibles se incluyen los siguientes.

Código o valor devuelto Descripción
S_OK
 El método se completó correctamente.
VDS_E_BAD_COOKIE
0x80042411L
 La cookie no existe.
VDS_E_INITIALIZED_FAILED
0x80042401L
 VDS no se pudo inicializar. Si una aplicación llama a este método antes de que el servicio termine de inicializarse, el método se bloqueará hasta que se complete la inicialización. Si se produce un error en la inicialización, se devuelve este error.

Comentarios

Use el método Advise para registrar la interfaz IVdsAdviseSink de la aplicación VDS para recibir notificaciones de VDS. El aviso devuelve una cookie, que debe devolver como parámetro al método Unadvise .

Nota Una aplicación que llama a Advise debe llamar finalmente a Unadvise. Idealmente, debe llamar a Unadvise tan pronto como ya no necesite recibir notificaciones.
 
Es posible que el método Unadvise no se devuelva inmediatamente, ya que espera a que un bloqueo actualice la lista de aplicaciones cliente registradas y espere a que el subproceso de notificación envíe las notificaciones de cliente para salir. Si hay notificaciones pendientes que se van a enviar a la aplicación, el subproceso de notificación intenta enviarlos antes de salir.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vds.h
Library Uuid.lib

Consulte también

IVdsAdviseSink

IVdsService

IVdsService::Advise

Notificaciones de VDS