Metodo CVssWriter::GetSnapshotDeviceName (vswriter.h)

Il metodo GetSnapshotDeviceName restituisce il nome del dispositivo che ospita la copia shadow del volume o della condivisione file specificata. Questo metodo consente ai writer di supportare copie shadow di ripristino automatico e può essere chiamato solo durante l'elaborazione del metodo OnPostSnapshot .

Sintassi

HRESULT GetSnapshotDeviceName(
  [in]  LPCWSTR wszOriginalVolume,
  [out] LPCWSTR *ppwszSnapshotDevice
);

Parametri

[in] wszOriginalVolume

Nome del volume originale o del percorso UNC della condivisione file originale che contiene dati usati per il set di copia shadow corrente. Il nome del volume deve essere in uno dei formati seguenti e deve includere una barra rovesciata finale (\):

  • Percorso di una cartella montata, ad esempio Y:\MountX\
  • Lettera di unità, ad esempio D:\
  • Percorso GUID del volume del modulo \\?\Volume{GUID}\ (dove GUID identifica il volume)
  • Percorso UNC che specifica una condivisione file remota, ad esempio \\Clusterx\Share1\

[out] ppwszSnapshotDevice

Indirizzo di un LPCWSTR che riceverà un puntatore al nome del dispositivo della copia shadow.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Significato
S_OK
Restituito correttamente il nome del volume di copia shadow.
E_INVALIDARG
Uno dei valori dei parametri non è valido.
VSS_E_BAD_STATE
La chiamata non è stata effettuata durante l'evento PostSnapshot.
VSS_E_OBJECT_NOT_FOUND
Il parametro wszOriginalVolume non è uno dei volumi o delle condivisioni file nel set di copia shadow.

Commenti

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: Le condivisioni file remote non sono supportate fino a Windows 8 e Windows Server 2012.

Per ottenere il nome del volume originale per il parametro wszOriginalVolume , chiamare prima il metodo CVssWriter::GetCurrentVolumeCount per eseguire query sul numero di volumi nel set di copia shadow. Chiamare quindi il metodo CVssWriter::GetCurrentVolumeArray per enumerare i nomi originali dei volumi nel set di copia shadow.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008, Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vswriter.h (include Vss.h, VsWriter.h)
Libreria VssApi.lib