Classe IVssComponent (vswriter.h)
A interface IVssComponent é uma interface C++ (não COM) que contém métodos para examinar e modificar informações sobre componentes contidos no Documento de Componentes de Backup de um solicitante.
Os objetos IVssComponent só podem ser obtidos para os componentes que foram explicitamente adicionados ao Documento de Componentes de Backup durante uma operação de backup pelo método IVssBackupComponents::AddComponent.
Informações sobre componentes explicitamente adicionados durante uma operação de restauração usando IVssBackupComponents::AddRestoreSubcomponent não estão disponíveis por meio da interface IVssComponent .
Algumas informações comuns a ambos os componentes e subcomponentes implicitamente selecionados disponíveis por meio de objetos IVssComponent incluem o seguinte:
- Carimbo de data/hora de backup
- Mensagens de falha pré/pós-restauração
- Restaurar metadados
- Destino de restauração
- Mapeamentos de localização alternativos
- Arquivos parciais
- Destino direcionado
A interface pode ser usada por um gravador ou um solicitante, embora determinados métodos tenham suporte apenas para gravadores. Dessa forma, um gravador pode solicitar alterações em uma operação de backup ou restauração, como adicionar um novo destino ou aprender ações do solicitante, como o uso de um local alternativo.
Os métodos a seguir retornam uma interface IVssComponent :
Herança
A interface IVssComponent herda da interface IUnknown . IVssComponent também tem estes tipos de membros:
Métodos
A classe IVssComponent tem esses métodos.
| IVssComponent::AddDifferencedFilesByLastModifyLSN Não há suporte. (IVssComponent.AddDifferencedFilesByLastModifyLSN) |
| IVssComponent::AddDifferencedFilesByLastModifyTime Usado por um gravador para indicar que um conjunto de arquivos (um arquivo ou arquivos especificado) deve ser avaliado em relação a um carimbo de data/hora da última modificação para inclusão em um backup incremental ou diferencial com carimbo de data/hora usando arquivos inteiros. |
| IVssComponent::AddDirectedTarget O método AddDirectedTarget permite que um gravador indique no momento da restauração que, quando um arquivo deve ser restaurado, ele (o arquivo de origem) deve ser remapeado. |
| IVssComponent::AddPartialFile O método AddPartialFile indica que apenas partes de um determinado arquivo devem ser copiadas em backup e quais partes são. |
| IVssComponent::GetAdditionalRestores O método GetAdditionalRestores é usado por um gravador durante operações de restauração incrementais ou diferenciais para determinar se um determinado componente exigirá operações de restauração adicionais para recuperá-lo completamente. |
| IVssComponent::GetAlternateLocationMapping O GetAlternateLocationMapping é usado para retornar o local alternativo de um conjunto de arquivos para restauração de arquivo. Esse método pode ser chamado por um gravador ou um solicitante. |
| IVssComponent::GetAlternateLocationMappingCount O método GetAlternateLocationMappingCount retorna o número de mapeamentos de localização alternativos usados por um solicitante na restauração de dados. Um gravador ou um solicitante pode chamar esse método. |
| IVssComponent::GetBackupMetadata O método GetBackupMetadata recupera metadados de backup privados específicos do gravador que podem ter sido definidos durante um evento PrepareForBackup por CVssWriter::OnPrepareBackup usando IVssComponent::SetBackupMetadata. |
| IVssComponent::GetBackupOptions O método GetBackupOptions retorna as opções de backup especificadas para o gravador que gerencia o componente ou componente atualmente selecionado definido por um solicitante usando IVssBackupComponents::SetBackupOptions. |
| IVssComponent::GetBackupStamp O método GetBackupStamp retorna a cadeia de caracteres de carimbo de backup armazenada por um gravador para um determinado componente. |
| IVssComponent::GetBackupSucceededed O método GetBackupSucceeded retorna a status de uma tentativa completa de fazer backup de todos os arquivos de um componente ou conjunto de componentes selecionado como uma enumeração VSS_FILE_RESTORE_STATUS. |
| IVssComponent::GetComponentName O método GetComponentName retorna o nome lógico desse componente. |
| IVssComponent::GetComponentType O método GetComponentType retorna o tipo desse componente em termos da enumeração VSS_COMPONENT_TYPE. |
| IVssComponent::GetDifferencedFile O método GetDifferencedFile retorna informações sobre um conjunto de arquivos (um arquivo ou arquivos especificado) para participar de um backup ou restauração incremental ou diferencial como um arquivo diferente, ou seja, backup e restaurações associados a ele devem ser implementados como se arquivos inteiros fossem copiados de e para a mídia de backup (em vez de usar arquivos parciais). |
| IVssComponent::GetDifferencedFilesCount Retorna o número de especificações de arquivo neste componente (e em qualquer subcomponente do conjunto de componentes definido por ele) marcado por um gravador que dá suporte a um backup incremental ou restauração como arquivos diferenciados. |
| IVssComponent::GetDirectedTarget O método GetDirectedTarget retorna informações armazenadas por um gravador, no momento do backup, para o Documento de Componentes de Backup para indicar que, quando um arquivo deve ser restaurado, ele (o arquivo de origem) deve ser remapeado. |
| IVssComponent::GetDirectedTargetCount O método GetDirectedTargetCount retorna o número de especificações de destino direcionadas associadas ao componente atual. Um gravador ou um solicitante pode chamar esse método. |
| IVssComponent::GetFileRestoreStatus O método GetFileRestoreStatus retorna o status de uma tentativa concluída de restaurar todos os arquivos de um componente ou conjunto de componentes selecionado como uma enumeração VSS_FILE_RESTORE_STATUS. |
| IVssComponent::GetLogicalPath O método GetLogicalPath retorna o caminho lógico desse componente. |
| IVssComponent::GetNewTarget O método GetNewTarget retorna os novos locais de restauração de arquivo para o componente ou conjunto de componentes selecionado. |
| IVssComponent::GetNewTargetCount O método GetNewTargetCount retorna o número de novos locais de restauração de destino associados a um determinado componente. |
| IVssComponent::GetPartialFile O método GetPartialFile retorna informações sobre um arquivo parcial associado a esse componente. |
| IVssComponent::GetPartialFileCount O método GetPartialFileCount retorna o número de arquivos parciais associados a um componente. |
| IVssComponent::GetPostRestoreFailureMsg O método GetPostRestoreFailureMsg retorna a mensagem de falha gerada por um gravador durante o tratamento do evento PostRestore, se IVssComponent::SetPostRestoreFailureMsg definir um. |
| IVssComponent::GetPreRestoreFailureMsg O método GetPreRestoreFailureMsg recupera a mensagem de erro gerada por um gravador durante o tratamento do evento PreRestore, se IVssComponent::SetPreRestoreFailureMsg definir um. |
| IVssComponent::GetPreviousBackupStamp O método GetPreviousBackupStamp retorna um carimbo de backup anterior carregado por um solicitante no Documento de Componentes de Backup. O valor é usado por um gravador ao decidir se os arquivos devem participar da operação de backup diferencial ou incremental. |
| IVssComponent::GetRestoreMetadata O método GetRestoreMetadata recupera metadados de restauração privados e específicos do gravador que podem ter sido definidos durante um evento PreRestore por CVssWriter::OnPreRestore usando IVssComponent::SetRestoreMetadata. |
| IVssComponent::GetRestoreOptions O método GetRestoreOptions obtém as opções de restauração especificadas para o gravador atual por um solicitante usando IVssBackupComponents::SetRestoreOptions. |
| IVssComponent::GetRestoreSubcomponent O método GetRestoreSubcomponent retorna o subcomponente especificado associado a um determinado componente. |
| IVssComponent::GetRestoreSubcomponentCount O método GetRestoreSubcomponentCount retorna o número de subcomponentes associados a um componente. |
| IVssComponent::GetRestoreTarget O método GetRestoreTarget retorna o destino de restauração (em termos da enumeração VSS_RESTORE_TARGET) para o componente atual. |
| IVssComponent::IsSelectedForRestore O método IsSelectedForRestore determina se o componente atual foi selecionado para ser restaurado. |
| IVssComponent::SetBackupMetadata O método SetBackupMetadata define metadados de backup com o componente . |
| IVssComponent::SetBackupStamp O método SetBackupStamp define uma cadeia de caracteres que contém informações que indicam quando um backup ocorreu. |
| IVssComponent::SetPostRestoreFailureMsg O método SetPostRestoreFailureMsg é usado para criar uma mensagem que descreve uma falha no processamento de um evento PostRestore. |
| IVssComponent::SetPreRestoreFailureMsg O método SetPreRestoreFailureMsg é usado para criar uma mensagem que descreve uma falha no processamento de um evento PreRestore. |
| IVssComponent::SetRestoreMetadata O método SetRestoreMetadata define metadados específicos do gravador para o componente atual. |
| IVssComponent::SetRestoreTarget O método SetRestoreTarget define o destino de restauração (em termos da enumeração VSS_RESTORE_TARGET) para o componente atual. |
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) |