Condividi tramite


Metodo IVdsVolumeMF::D eleteAccessPath (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 il percorso di accesso dal volume corrente.

Sintassi

HRESULT DeleteAccessPath(
  [in] LPWSTR pwszPath,
  [in] BOOL   bForce
);

Parametri

[in] pwszPath

Stringa che contiene il percorso di accesso da rimuovere. Un percorso di accesso può essere una lettera di unità o un percorso di una directory vuota in un volume NTFS. Se si tratta di una lettera di unità, è necessario includere una barra rovesciata finale, ad esempio "F:". Se si tratta di un percorso di una directory, la barra rovesciata finale non è necessaria, ad esempio "C:\MyFolder\MyDocuments".

[in] bForce

Se TRUE, il percorso di accesso viene eliminato in modo incondizionato, anche se il volume è in uso. Questo parametro è significativo solo quando il percorso di accesso è una lettera di unità.

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
Metodo completato correttamente.
VDS_E_OPERATION_DENIED
0x8004240AL
Il percorso porta al volume di sistema, al volume di avvio, al volume di arresto anomalo, al volume di ibernazione o al volume del file di pagina. Non è possibile rimuovere la lettera di unità da questi volumi.
VDS_E_PATH_NOT_FOUND
0x80042416L
Il percorso specificato non viene trovato.
VDS_E_DEVICE_IN_USE
0x80042413L
Il percorso di accesso è stato eliminato correttamente, tuttavia, si è verificato un errore. VDS potrebbe non riuscire ad aggiornare l'attributo GPT (GUID Partition Table) di una partizione o non è riuscito a eliminare una condivisione di rete predefinita (ad esempio F$) durante l'eliminazione della lettera di unità.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
Volume non riuscito.
VDS_E_PACK_OFFLINE
0x8004244L
Il pacchetto contenente il volume non è accessibile.

Commenti

Se nel volume non sono presenti handle aperti, la lettera di unità viene rimossa immediatamente. Tuttavia, se nel volume sono presenti handle aperti, il volume non può essere bloccato e la lettera di unità viene rimossa quando il computer viene riavviato.

Requisiti

   
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

IVdsVolumeMF

IVdsVolumeMF::AddAccessPath

IVdsVolumeMF::QueryAccessPaths