Metodo IVdsService::CleanupObsoleteMountPoints (vds.h)

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.

Rimuove i percorsi in modalità utente e le cartelle montate per i volumi che non esistono più.

Sintassi

HRESULT CleanupObsoleteMountPoints();

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.

Codice/valore restituito Descrizione
S_OK
I percorsi in modalità utente obsoleti e le cartelle montate sono stati rimossi correttamente.
VDS_E_INITIALIZED_FAILED
0x80042401L
Non è stato possibile inizializzare il VDS. Se un'applicazione chiama questo metodo prima che il servizio finisca l'inizializzazione, il metodo viene bloccato fino al completamento dell'inizializzazione. Se l'inizializzazione ha esito negativo, viene restituito questo errore.

Commenti

Per impostazione predefinita, il Registro di sistema mantiene le informazioni di mapping delle lettere di unità per i volumi disinstallati. Se il disco che contiene il volume viene rimosso dal computer, la voce del Registro di sistema viene mantenuta, in modo che se il disco e il volume restituiscono lo stesso computer, il volume riceve la stessa lettera di unità. Se il disco viene spostato in un nuovo computer, le voci del Registro di sistema non vengono spostate con esso, quindi il volume potrebbe ricevere una lettera di unità e un GUID del volume diversi.

Il metodo CleanupObsoleteMountPoints rimuove queste voci del Registro di sistema. Esistono tre tipi di voci del Registro di sistema rimosse:

  • Se il volume non ha una lettera di unità o un GUID del volume, ha una voce del Registro di sistema "nessuna lettera di unità", che viene rimossa da questo metodo.
  • In caso contrario, il volume include voci del Registro di sistema per un GUID del volume e possibilmente una lettera di unità. Entrambi vengono rimossi da questo metodo.
Inoltre, se il volume contiene cartelle montate, CleanupObsoleteMountPoints li rimuove. Ad esempio, se Volume1 su Disk1 viene rimosso e Volume1 viene montato come x:\MountVolume1 su Disk2, viene eliminata anche la cartella \MountVolume1 in Disk2.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vds.h
Libreria Uuid.lib

Vedi anche

IVdsService