Metodo IVssBackupComponents::ExposeSnapshot (vsbackup.h)

Articolo
03/08/2023

Il metodo ExposeSnapshot espone una copia shadow come lettera di unità, cartella montata o condivisione file.

Sintassi

HRESULT ExposeSnapshot(
  [in]  VSS_ID   SnapshotId,
  [in]  VSS_PWSZ wszPathFromRoot,
  [in]  LONG     lAttributes,
  [in]  VSS_PWSZ wszExpose,
  [out] VSS_PWSZ *pwszExposed
);

Parametri

[in] SnapshotId

Identificatore di copia shadow.

[in] wszPathFromRoot

Percorso della parte del volume reso disponibile quando si espone una copia shadow come condivisione file. Il valore di questo parametro deve essere NULL quando si espone una copia shadow in locale; ovvero, esponendolo come lettera di unità o cartella montata.

Il percorso non può contenere variabili di ambiente,ad esempio %MyEnv%) o caratteri jolly.

Non è necessario che il percorso termina con una barra rovesciata (""). Si tratta di applicazioni che recuperano queste informazioni da controllare.

[in] lAttributes

Attributi della copia shadow esposta che indica se è esposta in locale o in remoto. Il valore deve essere il VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY o il valore VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY di _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

[in] wszExpose

Quando una copia shadow viene esposta come condivisione file, il valore di questo parametro è il nome della condivisione. Se una copia shadow viene esposta montandola come dispositivo, il valore del parametro è una lettera di unità seguita da due punti, ad esempio "X:" o un percorso di cartella montato ,ad esempio "Y:\MountX"). Se il valore di questo parametro è NULL, VSS determina il nome della condivisione o la lettera di unità se il parametro lAttributes è VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY.

[out] pwszExposed

Nome esposto della copia shadow. Si tratta di un nome di condivisione, una lettera di unità seguita da due punti o una cartella montata. Il valore è NULL se ExposeSnapshot non è riuscito . VSS alloca la memoria per questa stringa.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK	Le copie shadow sono state esposte correttamente.
E_ACCESSDENIED	Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_BAD_STATE	L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino o questo metodo non è stato chiamato all'interno della sequenza corretta.
VSS_E_OBJECT_NOT_FOUND	La copia shadow specificata non esiste.
VSS_E_PROVIDER_VETO	Errore previsto del provider. Il provider ha registrato l'errore nel registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.
VSS_E_UNEXPECTED_PROVIDER_ERROR	Errore del provider imprevisto. Il codice di errore viene registrato nel log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.

Commenti

Il chiamante è responsabile della liberazione della stringa a cui punta il parametro pwszExposed chiamando la funzione CoTaskMemFree .

Quando si espone una copia shadow persistente, rimane esposta attraverso gli avvio successivi.

Quando si espone una copia shadow di un volume, la copia shadow può essere considerata come un dispositivo montabile o come file system disponibile per la condivisione file.

Quando viene esposta come dispositivo, come con altri dispositivi montabili, la copia shadow di un volume viene esposta al punto di montaggio (lettera di unità o cartella montata) a partire dalla radice.

Quando esposto come condivisione file, i subset (indicati da wszPathFromRoot) del volume possono essere condivisi.

Per altre informazioni su come esporre copie shadow, vedere Esposizione e surfing shadow copiato volumi.

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	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib