Compartilhar via

Método IVssBackupComponents::AddRestoreSubcomponent (vsbackup.h)

  • Artigo

O método AddRestoreSubcomponent indica que um membro subcomponente de um conjunto de componentes, que foi marcado como não selecionável para backup, mas está marcado como selecionável para restauração, deve ser restaurado independentemente de qualquer outro membro do conjunto de componentes ser restaurado.

Sintaxe

HRESULT AddRestoreSubcomponent(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE componentType,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszSubComponentLogicalPath,
  [in] LPCWSTR            wszSubComponentName,
  [in] bool               bRepair
);

Parâmetros

[in] writerId

Identificador de classe de gravador.

[in] componentType

Identifica o tipo do componente. Consulte a documentação de VSS_COMPONENT_TYPE para obter possíveis valores retornados.

[in] wszLogicalPath

Cadeia de caracteres largos terminada em nulo que contém o caminho lógico do componente no documento de backup que define o conjunto de componentes de backup que contém o subcomponente a ser adicionado para restauração.

O valor desse parâmetro pode ser NULL.

Não há restrições nos caracteres que podem aparecer em um caminho lógico não NULL .

[in] wszComponentName

Cadeia de caracteres largos terminada em nulo que contém o caminho lógico do componente no documento de backup que define o conjunto de componentes de backup que contém o subcomponente a ser adicionado para restauração.

O valor desse parâmetro não pode ser NULL.

Não há restrições sobre os caracteres que podem aparecer em um nome de componente não NULL .

[in] wszSubComponentLogicalPath

Cadeia de caracteres largos terminada em nulo que contém o caminho lógico do subcomponente a ser adicionado para restauração.

Um caminho lógico é necessário ao adicionar um subcomponente. Portanto, o valor desse parâmetro não pode ser NULL.

Não há restrições nos caracteres que podem aparecer em um caminho lógico não NULL .

[in] wszSubComponentName

Cadeia de caracteres largos terminada em nulo que contém o nome lógico do subcomponente a ser adicionado para restauração.

O valor desse parâmetro não pode ser NULL.

Não há restrições sobre os caracteres que podem aparecer em um nome de componente não NULL .

[in] bRepair

Esse parâmetro é reservado para uso futuro. Esse parâmetro sempre deve ser definido como false

Retornar valor

Veja a seguir os códigos de retorno válidos para esse método.

Valor Significado
S_OK
 Adicionado com êxito o subcomponente de restauração.
E_INVALIDARG
 Um dos valores de parâmetro não é válido.
E_OUTOFMEMORY
 O chamador está sem memória ou outros recursos do sistema.
VSS_E_BAD_STATE
 O objeto de componentes de backup não é inicializado, esse método não foi chamado durante uma operação de restauração ou esse método não foi chamado dentro da sequência correta.
VSS_E_INVALID_XML_DOCUMENT
 O documento XML não é válido. Verifique o log de eventos para obter detalhes. Para obter mais informações, consulte Tratamento de eventos e erros em VSS.
VSS_E_OBJECT_NOT_FOUND
 O componente não existe.
VSS_E_UNEXPECTED
 Erro inesperado. O código de erro é registrado no arquivo de log de erros. Para obter mais informações, consulte Tratamento de eventos e erros em VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008 R2 e o Windows 7. E_UNEXPECTED é usado.

Comentários

Antes de chamar AddRestoreSubcomponent, o componente raiz definido pelos parâmetros wszLogicalPath e wszComponentName deve primeiro ser selecionado para restauração usando IVssBackupComponents::SetSelectedForRestore.

Se um solicitante der suporte à restauração de subcomponentes, esse método deverá ser chamado antes de IVssBackupComponents::P reRestore.

AddRestoreSubcomponent destina-se ao caso em que todos os arquivos no conjunto de componentes de um gravador devem ser copiados como uma unidade, mas quando é desejável que os arquivos selecionados (subcomponentes) sejam capazes de serem restaurados individualmente.

Para participar dessa restauração, um subcomponente deve ter o membro bSelectableForRestore de VSS_COMPONENTINFO definido como TRUE. O componente definido pelos parâmetros wszLogicalPath e wszComponentName também deve ser selecionado para restauração usando IVssBackupComponents::SetSelectedForRestore.

Consulte Trabalhando com a selebilidade para restauração e subcomponentes para obter mais informações.

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 vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h)
Biblioteca VssApi.lib

Confira também

IVssBackupComponents

IVssBackupComponents::P reRestore

VSS_COMPONENT_TYPE