Compartilhar via


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
S_OK
A operação foi bem-sucedida.
E_INVALIDARG
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.
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 em 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 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

Confira também

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent