Condividi tramite

Metodo IVdsVolumeMF::AddAccessPath (vds.h)

  • Articolo

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

Aggiunge un percorso di accesso.

Sintassi

HRESULT AddAccessPath(
  [in] LPWSTR pwszPath
);

Parametri

[in] pwszPath

Stringa che indica il percorso di accesso, ovvero un percorso in modalità utente che può essere usato per aprire il volume. Un percorso di accesso può essere una lettera di unità o un percorso di una directory vuota in un volume NTFS. La stringa del percorso di accesso deve includere una barra rovesciata finale, ad esempio "F:".

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
 Il percorso è stato aggiunto correttamente.
S_FALSE
 Il percorso di accesso è stato aggiunto correttamente, tuttavia, si è verificato un errore. Il VDS potrebbe non riuscire ad aggiornare l'attributo GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER di una partizione o non è riuscito a aggiungere una condivisione di rete predefinita (ad esempio F$) durante l'aggiunta della lettera di unità. Per altre informazioni, vedere PARTITION_INFORMATION_GPT.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Volume non riuscito.
VDS_E_PACK_OFFLINE
0x8004244L
 Il pacchetto contenente il volume non è accessibile.

Commenti

VDS aggiunge il percorso di accesso creando una cartella montata (denominata anche punto di montaggio del volume). Si noti che le cartelle montate sono supportate solo nei volumi NTFS. Per altre informazioni, vedere Cartelle montate.

Questo metodo restituisce ERROR_DIR_NOT_EMPTY se il parametro pwszPath contiene un percorso di una cartella montata già in uso (anche se la directory è vuota) o se pwszPath contiene un percorso a una directory non interrotta.

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

SetVolumeMountPoint