Método IVssCreateWriterMetadata::AddDatabaseLogFiles (vswriter.h)
O método AddDatabaseLogFiles indica os arquivos de log associados a um banco de dados a ser feito backup, bem como sua localização.
Sintaxe
HRESULT AddDatabaseLogFiles(
[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 de banco de dados ao qual os arquivos de log serão adicionados.
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 componente de banco de dados associado aos arquivos de log. O tipo desse componente deve ser VSS_CT_DATABASE; caso contrário, o método retornará um erro.
[in] wszPath
Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o caminho do diretório que contém os arquivos de log.
O diretório pode ser um diretório local no computador VSS ou pode ser um diretório de compartilhamento de arquivos em um servidor de arquivos remoto.
Há suporte para caminhos UNC.
O caminho pode conter variáveis de ambiente (por exemplo, %SystemRoot%), mas não pode conter caracteres curinga.
Não há nenhum requisito de que o caminho termine com uma barra invertida (""). Cabe aos 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 dos arquivos de log 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 um determinado tipo de operações de backup.
O valor padrão para esse argumento é (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).
Valor retornado
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 ou o chamador tentou adicionar arquivos de banco de dados a um componente que não seja de banco de dados. |
|
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 em 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 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
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é o Windows 8 e o 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 AddDatabaseLogFiles (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 componente de banco de dados específico, o que pode ser necessário quando vários arquivos de log são armazenados em volumes separados.
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
| 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 |