Escritores

Writers são aplicativos ou serviços que armazenam informações persistentes em arquivos em disco e que fornecem os nomes e locais desses arquivos aos solicitantes usando a interface de cópia de sombra.

Durante as operações de backup, os gravadores garantem que seus dados sejam quiescentes e estáveis, adequados para cópia de sombra e backup. Os gravadores colaboram com restaurações desbloqueando arquivos quando possível e indicando locais alternativos quando necessário.

Se nenhum gravador estiver presente durante uma operação de backup do VSS, uma cópia de sombra ainda poderá ser criada. Nesse caso, todos os dados no volume copiado por sombra estarão no estado consistente com falhas.

Estado do gravador

Os gravadores mantêm seu estado em um objeto de metadados baseado em XML, o documento de metadados do gravador de .

Esses metadados de gravador são a única estrutura de dados que contém o conjunto de arquivos — caminho, especificação do arquivo e sinalizador de recursão — dos dados a serem copiados e restaurados.

O Documento de Metadados do Gravador organiza os conjuntos de arquivos do gravador em grupos ou componentes . A relação de um desses componentes durante operações de backup e restauração para os outros componentes gerenciados pelo gravador é descrita no Documento de Metadados do Gravador pela selebilidade do componente parade backup, sua selebilidade para restauraçãoe seus caminhos lógicos. (Para obter mais informações, consulte Configurando de organização de componentes e trabalhando com a selebilidade e os caminhos lógicos.)

Informações adicionais que regem a restauração de arquivos e outros problemas também estão contidas neste documento.

O solicitante precisa dos metadados do gravador, em conjunto com seu próprio Documento de Componentes de Backup, para processar um backup ou uma restauração.

Ao contrário do Documento de Componentes de Backup, o Documento de Metadados do Gravador deve ser considerado como uma estrutura somente leitura. Depois que um gravador o cria, o documento não é alterado.

Tratamento de eventos do gravador

As operações VSS de um gravador são iniciadas por meio do recebimento de eventos COM.

Quando nenhum evento está presente, um gravador não executa operações VSS (como um backup ou restauração do VSS). Em vez disso, ele executa seu trabalho normal, como responder a consultas de banco de dados, gerenciar dados do usuário ou fornecer outros serviços.

Para garantir que o tratamento de erros para várias sessões paralelas de backup e restauração seja executado corretamente e garantir que uma sessão de backup ou restauração não corrompa outra, faça o seguinte:

• Se o manipulador de eventos de um gravador (como CVssWriter::OnFreeze) chamar o CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailureou método CVssWriterEx2::SetWriterFailureEx, o manipulador de eventos deve chamar o método no mesmo thread que chamou o manipulador de eventos.
• A implementação do gravador de um manipulador de eventos como OnFreeze pode descarregar o trabalho para threads de trabalho, se desejado, desde que cada thread de trabalho faça marshaling de todos os relatórios de erros necessários para o thread do manipulador de eventos original.

Manipulando eventos de identificação

Com exceção do evento Identifique, o tipo e a ordem dos eventos que um gravador recebe dependem exclusivamente do tipo de operações VSS que estão em andamento no momento.

O evento Identifique requer que os gravadores forneçam informações do sistema sobre sua configuração e os arquivos que eles gerenciam por meio de seusde documentos de metadados do gravador de. Um evento Identifique é gerado com suporte de quase qualquer operação vss, incluindo consultas do sistema, bem como operações de cópia de sombra e backup e restauração. Portanto, a implementação de qualquer gravador do manipulador de eventos Identifique CVssWriter::OnIdentify deve ser capaz de lidar com um evento identificá-lo a qualquer momento, inclusive no meio do processamento de outra operação VSS, como um backup ou restauração. Um evento Identifi nunca deve ser considerado como parte do ciclo de vida de uma operação vss, embora sua geração possa ser esperada e necessária antes do início dessa operação.

É particularmente importante que as informações de estado sobre uma operação VSS não sejam modificadas em CVssWriter::OnIdentify, pois o recebimento de um evento fora de ordem redefiniria essas informações.

Eventos de backup e restauração

Dependendo se ele estiver participando de um backup ou restauração, um gravador receberá entre dois e sete eventos, além de um evento de identificação inicial.

Lidar com esses eventos constitui (do ponto de vista de um gravador) o ciclo de vida de uma operação de backup ou restauração.

Em uma operação de backup típica (consulte Visão geral do processamento de um backup emVSS), um gravador manipularia os seguintes eventos (além de um evento de identificação inicial):

• PrepareForBackup
• PrepareForSnapshot
• Congelar
• Descongelar
• PostSnapshot
• BackupComplete
• BackupShutdown

Em uma operação de restauração típica (consulte Visão geral do processamento de uma restauração emVSS), um gravador manipularia os seguintes eventos:

• Pré-Repositório
• PostRestore