Método IVssCreateExpressWriterMetadata::AddFilesToFileGroup (vswriter.h)

Artigo
08/27/2023

Adiciona um conjunto de arquivos (um arquivo ou arquivos especificado) a um componente de grupo de arquivos especificado para um gravador expresso.

Sintaxe

HRESULT AddFilesToFileGroup(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszGroupName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive,
  [in] LPCWSTR wszAlternateLocation,
  [in] DWORD   dwBackupTypeMask
);

Parâmetros

[in] wszLogicalPath

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o caminho lógico (que pode ser NULL) do componente ao qual adicionar os arquivos. Para obter mais informações, consulte Caminhos lógicos de componentes.

[in] wszGroupName

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o nome do componente do grupo de arquivos. O tipo desse componente deve ser VSS_CT_FILEGROUP; caso contrário, o método retornará um erro.

[in] wszPath

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o diretório raiz padrão dos arquivos a serem adicionados.

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 a aplicativos que recuperam essas informações marcar.

[in] wszFilespec

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que contém a especificação de arquivo dos arquivos a serem incluídos.

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] bRecursive

Um valor booliano que especifica se o caminho especificado pelo parâmetro wszPath identifica apenas um único diretório ou se indica uma hierarquia de diretórios a serem percorridos recursivamente. Esse parâmetro deverá ser definido como true se o caminho for tratado como uma hierarquia de diretórios a serem recursados ou false caso contrário.

Para obter informações sobre como percorrer pastas montadas, consulte Trabalhando com pastas montadas e pontos de nova análise.

[in] wszAlternateLocation

Esse parâmetro é reservado e deve ser NULL.

[in] dwBackupTypeMask

Uma máscara de bits 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.

Esse parâmetro não pode incluir VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED, VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED ou VSS_FSBT_LOG_BACKUP_REQUIRED.

O valor padrão desse 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 grupo de arquivos a um componente que não é de grupo de arquivos.
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.

Requisitos


Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [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

IVssCreateExpressWriterMetadata

Compartilhar via