Compartilhar via


Método IVssComponent::GetBackupOptions (vswriter.h)

O método GetBackupOptions retorna as opções de backup especificadas para o gravador que gerencia o componente ou componente atualmente selecionado definido por um solicitante usando IVssBackupComponents::SetBackupOptions.

Um gravador ou um solicitante pode chamar esse método.

Sintaxe

HRESULT GetBackupOptions(
  [out] BSTR *pbstrBackupOptions
);

Parâmetros

[out] pbstrBackupOptions

O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres que contém as opções de backup para o gravador atual.

Retornar valor

Veja a seguir os códigos de retorno válidos para esse método.

Valor Significado
S_OK
Retornou com êxito o valor do atributo.
S_FALSE
Nenhuma opção de backup foi especificada para este componente.
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.

Comentários

Se nenhuma opção de backup tiver sido definida, S_FALSE será retornado.

Se a chamada para GetBackupOptions for bem-sucedida, o chamador será responsável por liberar a cadeia de caracteres retornada no parâmetro pbstrBackupOptions chamando a função SysFreeString .

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

IVssBackupComponents::SetBackupOptions

IVssComponent

IVssComponent::GetRestoreOptions