Поделиться через

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

  • Статья

Метод GetRestoreMetadata извлекает частные метаданные восстановления, относящиеся к средству записи, которые могли быть заданы во время события PreRestoreCVssWriter::OnPreRestore с помощью IVssComponent::SetRestoreMetadata.

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

Синтаксис

HRESULT GetRestoreMetadata(
  [out] BSTR *pbstrRestoreMetadata
);

Параметры

[out] pbstrRestoreMetadata

Строка, содержащая метаданные восстановления.

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

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

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

Комментарии

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

Вызывающий объект должен освободить память, хранящуюся в параметре pbstrRestoreMetadata , вызвав SysFreeString.

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

Модуль записи, задающий метод восстановления для VSS_RME_RESTORE_TO_ALTERNATE_LOCATION без определения сопоставления альтернативного расположения, представляет собой ошибку записи.

Требования

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

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

IVssComponent