structure VSS_SNAPSHOT_PROP (vss.h)

Article
08/27/2023

La structure VSS_SNAPSHOT_PROP contient les propriétés d’un cliché instantané ou d’un jeu de clichés instantanés.

Syntaxe

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;

Membres

m_SnapshotId

Un VSS_ID (GUID) identifiant de manière unique l’identificateur de cliché instantané.

m_SnapshotSetId

Un VSS_ID (GUID) identifiant de manière unique le jeu de clichés instantanés contenant le cliché instantané.

m_lSnapshotsCount

Nombre de volumes inclus avec le cliché instantané dans le jeu de cliché instantané lors de sa création. Étant donné qu’il est possible pour les applications de libérer des clichés instantanés individuels sans libérer le jeu de clichés instantanés, le nombre de clichés instantanés dans le jeu de clichés instantanés peut être inférieur à m_LSnapshotsCount.

Le nombre maximal de volumes copiés par ombre autorisés dans un jeu de clichés instantanés est de 64.

m_pwszSnapshotDeviceObject

Chaîne de caractères larges terminée par null contenant le nom de l’objet d’appareil pour le cliché instantané du volume. L’objet d’appareil peut être considéré comme la racine d’un cliché instantané d’un volume. Les demandeurs utilisent ce nom d’appareil lors de l’accès aux fichiers sur un volume copié en ombre qu’il doit utiliser.

Le nom de l’appareil ne contient pas de fin « ».

m_pwszOriginalVolumeName

Chaîne de caractères larges terminée par null contenant le nom du volume qui avait été copié en ombre.

m_pwszOriginatingMachine

Chaîne de caractères larges terminée par null contenant le nom de l’ordinateur contenant le volume d’origine.

m_pwszServiceMachine

Chaîne de caractères larges terminée par null contenant le nom de l’ordinateur exécutant le service de cliché instantané de volume qui a créé le cliché instantané.

m_pwszExposedName

Chaîne de caractères larges terminée par null contenant le nom du cliché instantané lorsqu’il est exposé. Il s’agit d’une lettre de lecteur ou d’un dossier monté (si le cliché instantané est exposé en tant que volume local) ou d’un nom de partage. Correspond au paramètre wszExpose de la méthode IVssBackupComponents ::ExposeSnapshot .

m_pwszExposedPath

Chaîne de caractères larges terminée par null indiquant la partie du cliché instantané d’un volume mis à disposition s’il est exposé en tant que partage. Correspond au paramètre wszPathFromRoot de la méthode IVssBackupComponents ::ExposeSnapshot .

m_ProviderId

Un VSS_ID (GUID) identifiant de manière unique le fournisseur utilisé pour créer ce cliché instantané.

m_lSnapshotAttributes

Attributs du cliché instantané exprimé en tant que masque de bits (ou OR au niveau du bit) des membres de l’énumération _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

m_tsCreationTimestamp

Horodatage indiquant quand le cliché instantané a été créé. L’heure exacte est déterminée par le fournisseur. Consultez VSS_TIMESTAMP pour plus d’informations sur le format d’horodatage.

m_eStatus

Status de création de cliché instantané actuel. Voir VSS_SNAPSHOT_STATE.

Remarques

Les demandeurs obtiennent généralement un pointeur vers une structure VSS_SNAPSHOT_PROP à l’aide de la méthode IVssBackupComponents ::GetSnapshotProperties ou de la méthode IVssSoftwareSnapshotProvider ::GetSnapshotProperties . Lorsque cette structure n’est plus nécessaire, l’appelant est chargé de la libérer à l’aide de la fonction VssFreeSnapshotProperties .

L’objet de périphérique de cliché instantané contenu dans m_pwszSnapshotDeviceObject est utilisé pour traiter les fichiers sur le cliché instantané du volume. Par instance, si le volume d’origine a un fichier avec un chemin d’accès « \topleveldir\File.html », le chemin d’accès au cliché instantané du fichier est « m_pwszSnapshotDeviceObject »+« \topleveldir\File.html ».

Lorsqu’un cliché instantané est exposé en tant que partage, la valeur de m_pwszExposedName est le nom du partage. Lorsque le cliché instantané est exposé sous la forme d’une lettre de lecteur ou d’un dossier monté, le cliché instantané m_pwszExposedName est une lettre de lecteur suivie d’un signe deux-points, par exemple, « X : » ou un chemin d’accès de dossier monté (par exemple, « Y :\MountX »).

Si un cliché instantané est exposé sous la forme d’une lettre de lecteur ou d’un dossier monté, (comme pour le montage d’un appareil), le cliché instantané entier commençant à la racine est exposé au point de montage. Dans ce cas, m_pwszExposedPath sera null.

Si le cliché instantané est exposé en tant que partage, la valeur de m_pwszExposedPath correspond au chemin d’accès à la partie du volume qui est partagée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	vss.h