VSS_SNAPSHOT_PROP estructura (vss.h)
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 |
Consulte también
IVssBackupComponents::ExposeSnapshot
IVssBackupComponents::GetSnapshotProperties