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

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

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