Compartir a través de


Método IVdsProviderPrivate::OnUnload (vdshwprv.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.]

Solicita al objeto de proveedor que desinicialice a sí mismo.

Sintaxis

HRESULT OnUnload(
  [in] BOOL bForceUnload
);

Parámetros

[in] bForceUnload

Si es true, VDS intenta descargar forzosamente el proveedor. Si es false, VDS no realiza este intento.

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 se pueden originar en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los posibles valores devueltos se incluyen los siguientes.

Código devuelto Descripción
S_OK
El proveedor se descarga.
S_FALSE
El proveedor no puede descargarse en este momento. VDS vuelve a intentarlo más tarde.

Comentarios

VDS llama a este método inmediatamente antes de liberar la referencia al objeto de proveedor. Cuando el recuento de referencias cae a cero, el proveedor se descarga. Si se produce un error en el método OnLoad , VDS no llama a OnUnload.

Notas para los implementadores: Debe realizar toda la limpieza necesaria, incluso sin la llamada a OnUnload.

Requisitos

Requisito Value
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 vdshwprv.h
Library Uuid.lib

Consulte también

IVdsProviderPrivate

IVdsProviderPrivate::OnLoad