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 |
---|---|
|
Restituito correttamente il nome del volume di copia shadow. |
|
Uno dei valori dei parametri non è valido. |
|
La chiamata non è stata effettuata durante l'evento PostSnapshot. |
|
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 |