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


Функция CreateVssExamineWriterMetadataInternal (vsbackup.h)

Функция CreateVssExamineWriterMetadata создает объект IVssExamineWriterMetadata .

Примечание Эта функция экспортируется как CreateVssExamineWriterMetadataInternal, но следует вызывать CreateVssExamineWriterMetadata, а не CreateVssExamineWriterMetadataInternal.

 

Синтаксис

HRESULT CreateVssExamineWriterMetadataInternal(
  [in]  BSTR                      bstrXML,
  [out] IVssExamineWriterMetadata **ppMetadata
);

Параметры

[in] bstrXML

Xml-строка, содержащая документ метаданных модуля записи, с помощью которого инициализируется возвращенный объект IVssExamineWriterMetadata .

[out] ppMetadata

Переменная, получающая указатель интерфейса IVssExamineWriterMetadata на объект .

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

Приведенные здесь возвращаемые значения являются дополнением к обычным COM HRESULT, которые могут быть возвращены в любое время из функции.

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

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED.

Комментарии

Чтобы сохранить копию документа метаданных модуля записи в XML-строку для передачи параметра bstrXML , используйте метод IVssExamineWriterMetadata::SaveAsXML .

Чтобы получить последнюю версию документа метаданных модуля записи, используйте метод IVssBackupComponents::GetWriterMetadata .

Чтобы загрузить документ метаданных модуля записи в существующий объект IVssExamineWriterMetadata , используйте метод IVssExamineWriterMetadata::LoadFromXML .

Пользователи не должны пытаться изменить содержимое документа метаданных записи.

Вызывающее приложение отвечает за вызов IUnknown::Release , чтобы освободить ресурсы, хранящиеся в объекте IVssExamineWriterMetadata , когда объект больше не нужен.

Требования

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

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

IVssExamineWriterMetadata