VSS_SNAPSHOT_PROP estructura (vss.h)

Artículo
08/27/2023

La estructura VSS_SNAPSHOT_PROP contiene las propiedades de un conjunto de instantáneas o instantáneas.

Sintaxis

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;

Miembros

m_SnapshotId

Un VSS_ID (GUID) identifica de forma única el identificador de instantáneas.

m_SnapshotSetId

Un VSS_ID (GUID) identifica de forma única el conjunto de instantáneas que contiene la instantánea.

m_lSnapshotsCount

Número de volúmenes incluidos con la instantánea en el conjunto de instantáneas cuando se creó. Dado que es posible que las aplicaciones liberen instantáneas individuales sin liberar el conjunto de instantáneas, en cualquier momento el número de instantáneas del conjunto de instantáneas puede ser menor que m_LSnapshotsCount.

El número máximo de volúmenes copiados en sombra permitidos en un conjunto de instantáneas es 64.

m_pwszSnapshotDeviceObject

Cadena de caracteres anchos terminada en NULL que contiene el nombre del objeto de dispositivo para la instantánea del volumen. El objeto de dispositivo se puede considerar como la raíz de una instantánea de un volumen. Los solicitantes usarán este nombre de dispositivo al acceder a los archivos de un volumen copiado en la sombra con el que necesita trabajar.

El nombre del dispositivo no contiene una "" final.

m_pwszOriginalVolumeName

Cadena de caracteres anchos terminada en NULL que contiene el nombre del volumen que se había sombreado.

m_pwszOriginatingMachine

Cadena de caracteres anchos terminada en NULL que contiene el nombre de la máquina que contiene el volumen original.

m_pwszServiceMachine

Cadena de caracteres anchos terminada en NULL que contiene el nombre de la máquina que ejecuta el Servicio de instantáneas de volumen que creó la instantánea.

m_pwszExposedName

Cadena de caracteres anchos terminada en NULL que contiene el nombre de la instantánea cuando se expone. Se trata de una letra de unidad o una carpeta montada (si la instantánea se expone como un volumen local) o un nombre de recurso compartido. Corresponde al parámetro wszExpose del método IVssBackupComponents::ExposeSnapshot .

m_pwszExposedPath

Cadena de caracteres anchos terminada en NULL que indica la parte de la instantánea de un volumen disponible si se expone como un recurso compartido. Corresponde al parámetro wszPathFromRoot del método IVssBackupComponents::ExposeSnapshot .

m_ProviderId

Un VSS_ID (GUID) que identifica de forma única el proveedor usado para crear esta instantánea.

m_lSnapshotAttributes

Los atributos de la instantánea expresadas como máscara de bits (o OR bit a bit) de los miembros de la enumeración _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

m_tsCreationTimestamp

Marca de tiempo que indica cuándo se creó la instantánea. El proveedor determina la hora exacta. Consulte VSS_TIMESTAMP para obtener información sobre el formato de marca de tiempo.

m_eStatus

Estado actual de creación de instantáneas. Consulte VSS_SNAPSHOT_STATE.

Comentarios

Normalmente, los solicitantes obtienen un puntero a una estructura de VSS_SNAPSHOT_PROP mediante el método IVssBackupComponents::GetSnapshotProperties o el método IVssSoftwareSnapshotProvider::GetSnapshotProperties . Cuando esta estructura ya no es necesaria, el autor de la llamada es responsable de liberarla mediante la función VssFreeSnapshotProperties .

El objeto de dispositivo de instantáneas contenido en m_pwszSnapshotDeviceObject se usa para dirigir los archivos en la instantánea del volumen. Por ejemplo, si el volumen original tiene un archivo con una ruta de acceso de "\topleveldir\File.html", la ruta de acceso a la instantánea del archivo es "m_pwszSnapshotDeviceObject"+"\topleveldir\File.html".

Cuando una instantánea se expone como un recurso compartido, el valor de m_pwszExposedName será el nombre del recurso compartido. Cuando la instantánea se expone como una letra de unidad o una carpeta montada, la instantánea m_pwszExposedName es una letra de unidad seguida de dos puntos( por ejemplo, "X:" o una ruta de acceso de carpeta montada (por ejemplo, "Y:\MountX").

Si una instantánea se expone como una letra de unidad o una carpeta montada, (como con el montaje de cualquier dispositivo), toda la instantánea que comienza en su raíz se expondrá en el punto de montaje. En este caso, m_pwszExposedPath será null.

Si la instantánea se expone como un recurso compartido, el valor de m_pwszExposedPath será la ruta de acceso a la parte del volumen que se comparte.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	vss.h