IVdsService::CleanupObsoleteMountPoints-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.]
Entfernt Pfade im Benutzermodus und eingebundene Ordner für Volumes, die nicht mehr vorhanden sind.
Syntax
HRESULT CleanupObsoleteMountPoints();
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 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 |
|---|---|
|
Veraltete Benutzermoduspfade und eingebundene Ordner wurden erfolgreich entfernt. |
|
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. |
Hinweise
Standardmäßig behält die Registrierung die Laufwerkbuchstabenzuordnungsinformationen für deinstallierte Volumes bei. Wenn der Datenträger, der das Volume enthält, vom Computer entfernt wird, wird der Registrierungseintrag beibehalten, sodass das Volume denselben Laufwerkbuchstaben erhält, wenn der Datenträger und das Volume auf denselben Computer zurückkehren. Wenn der Datenträger auf einen neuen Computer verschoben wird, werden die Registrierungseinträge nicht mit diesem verschoben, sodass das Volume möglicherweise einen anderen Laufwerkbuchstaben und eine andere Volume-GUID erhält.
Die CleanupObsoleteMountPoints-Methode entfernt diese Registrierungseinträge. Es gibt drei Arten von Registrierungseinträgen, die entfernt werden:
- Wenn das Volume keinen Laufwerkbuchstaben oder eine Volume-GUID aufweist, verfügt es über einen Registrierungseintrag "Kein Laufwerkbuchstabe", der von dieser Methode entfernt wird.
- Andernfalls enthält das Volume Registrierungseinträge für eine Volume-GUID und möglicherweise einen Laufwerkbuchstaben. Beide werden von dieser Methode entfernt.
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 | vds.h |
| Bibliothek | Uuid.lib |