Classe CVssWriter (vswriter.h)
A classe CVssWriter é uma classe base abstrata que define a interface pela qual um gravador sincroniza seu estado com VSS e outros gravadores.
Cada gravador deve instanciar um objeto derivado de CVssWriter.
Objetos derivados de CVssWriter devem fornecer implementações para todos os métodos virtuais puros do CVssWriter.
Um gravador pode substituir um ou todos os métodos virtuais do CVssWriter.
Para participar do VSS, um gravador deve primeiro chamar CVssWriter::Initialize e, em seguida, chamar CVssWriter::Subscribe.
Um gravador encerra sua participação chamando CVssWriter::Unsubscribe.
A classe base CVssWriter é responsável pelo ciclo de vida das interfaces passadas para manipuladores de eventos. Isso inclui o seguinte:
- A instância da interface IVssWriterComponents passada para: CVssWriter::OnPrepareBackup
- A instância da interface IVssCreateWriterMetadata passada para CVssWriter::OnIdentify.
Métodos
A classe CVssWriter tem esses métodos.
| CVssWriter::~CVssWriter ~CVssWriter é o destruidor do objeto de classe CVssWriter. |
| CVssWriter::AreComponentsSelected O método AreComponentsSelected indica se um solicitante está em execução no modo de componente e dá suporte à seleção de componentes individuais para fazer backup ou fazer backup de volumes inteiros. |
| CVssWriter::CVssWriter CVssWriter é o construtor do objeto de classe CVssWriter. |
| CVssWriter::GetBackupType O método GetBackupType indica o tipo de backup a ser executado. |
| CVssWriter::GetContext As informações de GetContext retornam o contexto atual para quaisquer cópias de sombra contínuas ou possíveis. |
| CVssWriter::GetCurrentLevel O método GetCurrentLevel retorna o nível de aplicativo atual. |
| CVssWriter::GetCurrentSnapshotSetId O método GetCurrentSnapshotSetId retorna o identificador exclusivo do conjunto de cópias de sombra. |
| CVssWriter::GetCurrentVolumeArray O método GetCurrentVolumeArray retorna os nomes dos volumes originais e os caminhos UNC dos compartilhamentos de arquivos remotos originais que pertencem ao conjunto de cópias de sombra como uma matriz de cadeias de caracteres largos terminadas em nulo. Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: compartilhamentos de arquivos remotos não têm suporte até Windows 8 e Windows Server 2012. |
| CVssWriter::GetCurrentVolumeCount O método GetCurrentVolumeCount retorna o número de volumes no conjunto de cópias de sombra. |
| CVssWriter::GetRestoreType O método GetRestoreType retorna o tipo de restauração do qual um gravador está participando. |
| CVssWriter::GetSnapshotDeviceName O método GetSnapshotDeviceName retorna o nome do dispositivo que hospeda a cópia de sombra do volume ou compartilhamento de arquivo especificado. |
| CVssWriter::Initialize Inicializa um objeto CVssWriter e permite que um aplicativo gravador interaja com o VSS. |
| CVssWriter::InstallAlternateWriter Não há suporte. (CVssWriter.InstallAlternateWriter) |
| CVssWriter::IsBootableSystemStateBackedUp O método IsBootableSystemStateBackedUp indica se o estado inicializável será feito o backup. |
| CVssWriter::IsPartialFileSupportEnabled O método IsPartialFileSupportEnabled determina se o suporte parcial ao arquivo está habilitado ou desabilitado. |
| CVssWriter::IsPathAffected O método IsPathAffected determina se o diretório ou arquivo especificado está incluído no conjunto de cópias de sombra atual. O caminho para o diretório ou arquivo pode ser um caminho local ou um caminho UNC de um compartilhamento de arquivos remoto. |
| CVssWriter::OnAbort O método OnAbort é chamado por um gravador após um evento Abort emitido pelo VSS indicando que uma operação de cópia de sombra foi encerrada prematuramente. O gravador usa esse método para limpo de sua tentativa de participar dessa operação. |
| CVssWriter::OnBackOffIOOnVolume Não há suporte. (CVssWriter.OnBackOffIOOnVolume) |
| CVssWriter::OnBackupComplete O método OnBackupComplete é chamado por um gravador após um evento BackupComplete. Ele é usado para executar operações consideradas necessárias após um backup. No entanto, essas operações não podem modificar o Documento de Componentes de Backup. |
| CVssWriter::OnBackupShutdown O método OnBackupShutdown é chamado por um gravador após um evento BackupShutdown. Ele é usado para executar operações consideradas necessárias quando um aplicativo de backup é desligado, especialmente no caso de uma falha do aplicativo de backup. |
| CVssWriter::OnContinueIOOnVolume Não há suporte. (CVssWriter.OnContinueIOOnVolume) |
| CVssWriter::OnFreeze O método OnFreeze é chamado por um gravador ao receber um evento Freeze no início de um congelamento de cópia de sombra. Um gravador usa esse método para executar operações necessárias para participar do congelamento ou para vetar o congelamento. |
| CVssWriter::OnIdentify O método OnIdentify é chamado por um gravador após o recebimento de um evento Identifi. |
| CVssWriter::OnPostRestore O método OnPostRestore é chamado por um gravador após um evento PostRestore. Ele é usado para executar operações consideradas necessárias depois que os arquivos são restaurados no disco por um solicitante. No entanto, essas operações não podem modificar o Documento de Componentes de Backup. |
| CVssWriter::OnPostSnapshot O método OnPostSnapshot é chamado por um gravador após um evento PostSnapshot. |
| CVssWriter::OnPrepareBackup O método OnPrepareBackup é chamado por um gravador após um evento PrepareForBackup. Esse método é usado para configurar o estado de um gravador e seus componentes em preparação para uma operação de backup. |
| CVssWriter::OnPrepareSnapshot O método OnPrepareSnapshot é chamado por um gravador para manipular um evento PrepareForSnapshot. Ele é usado para executar operações necessárias para preparar um gravador para participar da cópia de sombra ou para vetar uma cópia de sombra. |
| CVssWriter::OnPreRestore O método OnPreRestore é chamado por um gravador após um evento PreRestore. |
| CVssWriter::OnThaw O método OnThaw é chamado por um gravador após um evento Thaw. |
| CVssWriter::OnVSSApplicationStartup Não há suporte. (CVssWriter.OnVSSApplicationStartup) |
| CVssWriter::OnVSSShutdown Não há suporte. (CVssWriter.OnVssShutdown) |
| CVssWriter::SetWriterFailure O método SetWriterFailure indica que esse gravador encontrou uma condição de erro e define uma condição de erro. |
| CVssWriter::Subscribe O método Subscribe assina o gravador com VSS. |
| CVssWriter::Unsubscribe O método Unsubscribe cancela a assinatura do gravador com o VSS. |
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] |
| Plataforma de Destino | Windows |
| Cabeçalho | vswriter.h (inclua Vss.h, VsWriter.h) |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de