IVdsService::Refresh-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]
Aktualisiert Informationen zum Datenträgerbesitz und Datenträgerlayout.
Syntax
HRESULT Refresh();
Rückgabewert
Diese Methode kann HRESULT-Standardwerte wie E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros 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/-wert | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Während dieses Vorgangs ist ein Fehler aufgetreten. |
|
VDS konnte nicht initialisiert werden. Wenn eine Anwendung diese Methode aufruft, bevor der Dienst die Initialisierung abgeschlossen hat, wird die Methode blockiert, bis die Initialisierung abgeschlossen ist. Wenn bei der Initialisierung ein Fehler auftritt, wird dieser Fehler zurückgegeben. |
Bemerkungen
Diese Methode synchronisiert das Datenträgerlayout mit dem Layout, das dem Datenträgertreiber bekannt ist. Es zwingt den Treiber nicht, das Layout vom Datenträger zu lesen. Darüber hinaus aktualisiert diese Methode die Ansicht aller Objekte im VDS-Cache. VDS und die Anbieter fragen alle Objekte ab, senden Objektankunfts-, Änderungs- und Entfernungsbenachrichtigungen, um den Aufrufer zu synchronisieren. Beachten Sie, dass VDS den Cache automatisch aktualisiert, wenn eine Änderung erkannt wird, die eine Benachrichtigung auslöst. Aus diesem Grund und da der Aufruf von Refresh zusätzliche Benachrichtigungen auslösen kann, sollten Anwendungen diese Methode nicht als Reaktion auf Benachrichtigungen aufrufen. Aktualisieren sollte nur aufgerufen werden, wenn der Cache nicht ordnungsgemäß aktualisiert wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vds.h |
| Bibliothek | Uuid.lib |