estrutura VSS_SNAPSHOT_PROP (vss.h)

Artigo
08/27/2023

A estrutura VSS_SNAPSHOT_PROP contém as propriedades de uma cópia de sombra ou conjunto de cópias de sombra.

Sintaxe

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;

Membros

m_SnapshotId

Um GUID (VSS_ID ) que identifica exclusivamente o identificador de cópia de sombra.

m_SnapshotSetId

Um GUID (VSS_ID ) que identifica exclusivamente o conjunto de cópias de sombra que contém a cópia de sombra.

m_lSnapshotsCount

Número de volumes incluídos com a cópia de sombra no conjunto de cópias de sombra quando ele foi criado. Como é possível que os aplicativos liberem cópias de sombra individuais sem liberar o conjunto de cópias de sombra, a qualquer momento o número de cópias de sombra no conjunto de cópias de sombra pode ser menor que m_LSnapshotsCount.

O número máximo de volumes copiados por sombra permitidos em um conjunto de cópias de sombra é 64.

m_pwszSnapshotDeviceObject

Cadeia de caracteres largos terminada em nulo que contém o nome do objeto do dispositivo para a cópia de sombra do volume. O objeto de dispositivo pode ser considerado como a raiz de uma cópia de sombra de um volume. Os solicitantes usarão esse nome de dispositivo ao acessar arquivos em um volume copiado por sombra com o qual ele precisa trabalhar.

O nome do dispositivo não contém um "" à direita.

m_pwszOriginalVolumeName

Cadeia de caracteres largos terminada em nulo que contém o nome do volume que tinha sido copiado por sombra.

m_pwszOriginatingMachine

Cadeia de caracteres largos terminada em nulo que contém o nome do computador que contém o volume original.

m_pwszServiceMachine

Cadeia de caracteres largos terminada em nulo que contém o nome do computador que executa o Serviço de Cópia de Sombra de Volume que criou a cópia de sombra.

m_pwszExposedName

Cadeia de caracteres largos terminada em nulo que contém o nome da cópia de sombra quando ela é exposta. Essa é uma letra da unidade ou uma pasta montada (se a cópia de sombra for exposta como um volume local) ou um nome de compartilhamento. Corresponde ao parâmetro wszExpose do método IVssBackupComponents::ExposeSnapshot .

m_pwszExposedPath

Cadeia de caracteres largos terminada em nulo indicando a parte da cópia de sombra de um volume disponibilizado se ele for exposto como um compartilhamento. Corresponde ao parâmetro wszPathFromRoot do método IVssBackupComponents::ExposeSnapshot .

m_ProviderId

Um GUID (VSS_ID ) que identifica exclusivamente o provedor usado para criar essa cópia de sombra.

m_lSnapshotAttributes

Os atributos da cópia de sombra expressos como uma máscara de bits (ou OR bit a bit) de membros da enumeração _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

m_tsCreationTimestamp

Carimbo de data/hora que indica quando a cópia de sombra foi criada. A hora exata é determinada pelo provedor. Consulte VSS_TIMESTAMP para obter informações sobre o formato de carimbo de data/hora.

m_eStatus

Criação de cópia de sombra atual status. Confira VSS_SNAPSHOT_STATE.

Comentários

Os solicitantes normalmente obtêm um ponteiro para uma estrutura VSS_SNAPSHOT_PROP usando o método IVssBackupComponents::GetSnapshotProperties ou o método IVssSoftwareSnapshotProvider::GetSnapshotProperties . Quando essa estrutura não é mais necessária, o chamador é responsável por liberá-la usando a função VssFreeSnapshotProperties .

O objeto de dispositivo de cópia de sombra contido em m_pwszSnapshotDeviceObject é usado para endereçar arquivos na cópia de sombra do volume. Por exemplo, se o volume original tiver um arquivo com um caminho de "\topleveldir\File.html", o caminho para a cópia de sombra do arquivo será "m_pwszSnapshotDeviceObject"+"\topleveldir\File.html".

Quando uma cópia de sombra é exposta como um compartilhamento, o valor de m_pwszExposedName será o nome do compartilhamento. Quando a cópia de sombra é exposta como uma letra da unidade ou pasta montada, a cópia de sombra m_pwszExposedName é uma letra da unidade seguida por dois-pontos, por exemplo, "X:" ou um caminho de pasta montado (por exemplo, "Y:\MountX").

Se uma cópia de sombra for exposta como uma letra da unidade ou pasta montada, então (como com a montagem de qualquer dispositivo), toda a cópia de sombra começando na raiz será exposta no ponto de montagem. Nesse caso, m_pwszExposedPath será nulo.

Se a cópia de sombra for exposta como um compartilhamento, o valor de m_pwszExposedPath será o caminho para a parte do volume compartilhada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	vss.h