Método IVssBackupComponents::AddRestoreSubcomponent (vsbackup.h)
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 |
|---|---|
|
Adicionado com êxito o subcomponente de restauração. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
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. |
|
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. |
|
O componente não existe. |
|
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 |