structure VSS_SNAPSHOT_PROP (vss.h)
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 |
Voir aussi
IVssBackupComponents ::ExposeSnapshot
IVssBackupComponents ::GetSnapshotProperties