Método IVssCreateWriterMetadata::AddDatabaseFiles (vswriter.h)

  • Artigo

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
S_OK
 A operação foi bem-sucedida.
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_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 no VSS.
VSS_E_OBJECT_NOT_FOUND
 O componente especificado 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 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

Confira também

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent