struttura VSS_SNAPSHOT_PROP (vss.h)

Articolo
03/03/2024

La struttura VSS_SNAPSHOT_PROP contiene le proprietà di una copia shadow o di un set di copie shadow.

Sintassi

typedef struct _VSS_SNAPSHOT_PROP {
  VSS_ID             m_SnapshotId;
  VSS_ID             m_SnapshotSetId;
  LONG               m_lSnapshotsCount;
  VSS_PWSZ           m_pwszSnapshotDeviceObject;
  VSS_PWSZ           m_pwszOriginalVolumeName;
  VSS_PWSZ           m_pwszOriginatingMachine;
  VSS_PWSZ           m_pwszServiceMachine;
  VSS_PWSZ           m_pwszExposedName;
  VSS_PWSZ           m_pwszExposedPath;
  VSS_ID             m_ProviderId;
  LONG               m_lSnapshotAttributes;
  VSS_TIMESTAMP      m_tsCreationTimestamp;
  VSS_SNAPSHOT_STATE m_eStatus;
} VSS_SNAPSHOT_PROP, *PVSS_SNAPSHOT_PROP;

Members

m_SnapshotId

Un VSS_ID (GUID) che identifica in modo univoco l'identificatore di copia shadow.

m_SnapshotSetId

Un VSS_ID (GUID) che identifica in modo univoco il set di copie shadow contenente la copia shadow.

m_lSnapshotsCount

Numero di volumi inclusi nella copia shadow nel set di copie shadow al momento della creazione. Poiché è possibile che le applicazioni rilascino singole copie shadow senza rilasciare il set di copie shadow, in qualsiasi momento il numero di copie shadow nel set di copie shadow può essere minore di m_LSnapshotsCount.

Il numero massimo di volumi copiati dall'ombreggiatura consentiti in un set di copie shadow è 64.

m_pwszSnapshotDeviceObject

Stringa di caratteri wide con terminazione Null contenente il nome dell'oggetto dispositivo per la copia shadow del volume. L'oggetto dispositivo può essere considerato come la radice di una copia shadow di un volume. I richiedenti useranno questo nome del dispositivo quando accedono ai file in un volume copiato dall'ombreggiatura con cui deve funzionare.

Il nome del dispositivo non contiene un carattere finale "".

m_pwszOriginalVolumeName

Stringa di caratteri wide con terminazione Null contenente il nome del volume copiato dall'ombreggiatura.

m_pwszOriginatingMachine

Stringa di caratteri wide con terminazione Null contenente il nome del computer contenente il volume originale.

m_pwszServiceMachine

Stringa di caratteri wide con terminazione Null contenente il nome del computer che esegue il servizio Copia Shadow del volume che ha creato la copia shadow.

m_pwszExposedName

Stringa di caratteri wide con terminazione Null contenente il nome della copia shadow quando viene esposta. Si tratta di una lettera di unità o di una cartella montata (se la copia shadow è esposta come volume locale) o un nome di condivisione. Corrisponde al parametro wszExpose del metodo IVssBackupComponents::ExposeSnapshot .

m_pwszExposedPath

Stringa di caratteri wide con terminazione Null che indica la parte della copia shadow di un volume reso disponibile se viene esposta come condivisione. Corrisponde al parametro wszPathFromRoot del metodo IVssBackupComponents::ExposeSnapshot .

m_ProviderId

Un VSS_ID (GUID) che identifica in modo univoco il provider usato per creare questa copia shadow.

m_lSnapshotAttributes

Attributi della copia shadow espressi come maschera di bit (o OR bit per bit) dei membri dell'enumerazione _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

m_tsCreationTimestamp

Timestamp che indica quando è stata creata la copia shadow. L'ora esatta è determinata dal provider. Per informazioni sul formato timestamp, vedere VSS_TIMESTAMP.

m_eStatus

Stato di creazione della copia shadow corrente. Vedere VSS_SNAPSHOT_STATE.

Commenti

I richiedenti ottengono in genere un puntatore a una struttura VSS_SNAPSHOT_PROP usando il metodo IVssBackupComponents::GetSnapshotProperties o IVssSoftwareSnapshotProvider::GetSnapshotProperties . Quando questa struttura non è più necessaria, il chiamante è responsabile della liberazione tramite la funzione VssFreeSnapshotProperties .

L'oggetto dispositivo di copia shadow contenuto in m_pwszSnapshotDeviceObject viene usato per indirizzare i file nella copia shadow del volume. Ad esempio, se il volume originale ha un file con un percorso "\topleveldir\File.html", il percorso della copia shadow del file è "m_pwszSnapshotDeviceObject"+"\topleveldir\File.html".

Quando una copia shadow viene esposta come condivisione, il valore di m_pwszExposedName sarà il nome della condivisione. Quando la copia shadow viene esposta come lettera di unità o cartella montata, la copia shadow m_pwszExposedName è una lettera di unità seguita da due punti, ad esempio "X:" o un percorso di cartella montato (ad esempio, "Y:\MountX").

Se una copia shadow viene esposta come lettera di unità o cartella montata, come per il montaggio di qualsiasi dispositivo, l'intera copia shadow a partire dalla radice verrà esposta nel punto di montaggio. In questo caso, m_pwszExposedPath sarà Null.

Se la copia shadow viene esposta come condivisione, il valore di m_pwszExposedPath sarà il percorso della parte del volume condivisa.