IVdsProviderPrivate::OnUnload-Methode (vdshwprv.h)

  • Artikel

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]

Fordert das Anbieterobjekt auf, sich selbst aufzuheben.

Syntax

HRESULT OnUnload(
  [in] BOOL bForceUnload
);

Parameter

[in] bForceUnload

Wenn true, versucht VDS, den Anbieter zwangsaufzuheben. Bei false unternimmt VDS keinen solchen Versuch.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des makros HRESULT_FROM_WIN32 zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
 Der Anbieter wird entladen.
S_FALSE
 Der Anbieter kann derzeit nicht entladen werden. VDS versucht es später erneut.

Hinweise

VDS ruft diese Methode unmittelbar vor der Freigabe des Verweises auf das Anbieterobjekt auf. Wenn die Verweisanzahl auf 0 (null) sinkt, wird der Anbieter entladen. Wenn die OnLoad-Methode fehlschlägt, ruft VDS OnUnload nicht auf.

Hinweise für Implementierer: Sie müssen alle erforderlichen sauber ausführen, auch ohne den Aufruf von OnUnload.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vdshwprv.h
Bibliothek Uuid.lib

Weitere Informationen

IVdsProviderPrivate

IVdsProviderPrivate::OnLoad