Método IVssCreateWriterMetadata::AddDatabaseFiles (vswriter.h)
O método AddDatabaseFiles indica o conjunto de arquivos (o arquivo ou arquivos especificados) que compõem o componente de banco de dados a ser copiado em backup.
Sintaxe
HRESULT AddDatabaseFiles(
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszDatabaseName,
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] DWORD dwBackupTypeMask
);
Parâmetros
[in] wszLogicalPath
Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o caminho lógico do componente ao qual o banco de dados será adicionado.
Para obter mais informações, consulte Caminhos lógicos de componentes.
Um caminho lógico não é necessário e pode ser NULL.
[in] wszDatabaseName
Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o nome do banco de dados.
Esse nome é necessário e deve corresponder ao nome do componente ao qual o banco de dados está sendo adicionado.
[in] wszPath
Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o caminho do diretório que contém o arquivo de banco de dados.
O caminho pode conter variáveis de ambiente (por exemplo, %SystemRoot%), mas não pode conter caracteres curinga.
Há suporte para caminhos UNC.
Não há nenhum requisito de que o caminho termine com uma barra invertida (""). Cabe a aplicativos que recuperam essas informações marcar.
[in] wszFilespec
Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém a especificação de arquivo do arquivo ou arquivos associados ao banco de dados.
Uma especificação de arquivo não pode conter especificações de diretório (por exemplo, sem barras invertidas), mas pode conter o ? e * caracteres curinga.
[in] dwBackupTypeMask
Uma máscara de bits (ou OR bit a bit) de VSS_FILE_SPEC_BACKUP_TYPE valores de enumeração para indicar se um gravador deve avaliar o arquivo para participação em determinados tipos de operações de backup.
O valor padrão desse argumento é (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).
Retornar valor
Veja a seguir os códigos de retorno válidos para esse método.
| Valor | Significado |
|---|---|
|
A operação foi bem-sucedida. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
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 no VSS. |
|
O componente especificado 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 no 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
Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: Não há suporte para compartilhamentos de arquivos remotos até Windows 8 e Windows Server 2012. Os gravadores dão suporte apenas a recursos locais — conjuntos de arquivos cujo caminho absoluto começa com uma especificação de volume local válida e não pode ser uma unidade de rede mapeada. Portanto, as entradas de caminho (wszPath) para AddDatabaseFiles (após a resolução de qualquer variável de ambiente) devem estar nesse formato.
Esse método pode ser chamado várias vezes para um banco de dados específico. Isso é feito quando o banco de dados existe em arquivos armazenados em volumes separados, como é possível com o Microsoft SQL Server.
Os valores dos parâmetros wszLogicalPath e wszDatabaseName devem corresponder aos de um dos componentes de banco de dados adicionados anteriormente com o método IVssCreateWriterMetadata::AddComponent .
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) |
| Biblioteca | VssApi.lib |