Метод IVssComponent::GetBackupMetadata (vswriter.h)

  • Статья
  • Чтение занимает 2 мин

Метод GetBackupMetadata извлекает частные метаданные резервных копий, относящиеся к средству записи, которые могли быть заданы во время события PrepareForBackupCVssWriter::OnPrepareBackup с помощью IVssComponent::SetBackupMetadata.

Этот метод может вызывать только модуль записи.

Синтаксис

HRESULT GetBackupMetadata(
  [out] BSTR *pbstrData
);

Параметры

[out] pbstrData

Адрес выделенной вызывающей переменной, которая получает строку, содержащую метаданные резервной копии, добавленные во время события OnPrepareBackup .

Возвращаемое значение

Ниже приведены допустимые коды возврата для этого метода.

Значение Значение
S_OK
 Успешно возвращено значение атрибута.
S_FALSE
 Метаданные резервной копии, связанные с этим компонентом, отсутствуют.
E_INVALIDARG
 Одно из значений параметра недопустимо.
E_OUTOFMEMORY
 Вызывающий объект не хватает памяти или других системных ресурсов.
VSS_E_INVALID_XML_DOCUMENT
 Недопустимый XML-документ. Дополнительные сведения см. в журнале событий. Дополнительные сведения см. в разделе "Обработка событий и ошибок" в VSS.

Комментарии

Этот метод можно вызывать в любое время в зависимости от логики заданного модуля записи.

Если метаданные резервной копии не заданы, getBackupMetadata возвращает S_FALSE.

Если вызов GetBackupMetadata выполнен успешно, вызывающий объект отвечает за освобождение строки, возвращаемой в параметре pbstrMetadata , путем вызова функции SysFreeString .

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header vswriter.h (include Vss.h, VsWriter.h)
Библиотека VssApi.lib

См. также раздел

IVssComponent

IVssComponent::SetBackupMetadata