Функция CreateVssExamineWriterMetadataInternal (vsbackup.h)
Функция CreateVssExamineWriterMetadata создает объект IVssExamineWriterMetadata .
Синтаксис
HRESULT CreateVssExamineWriterMetadataInternal(
[in] BSTR bstrXML,
[out] IVssExamineWriterMetadata **ppMetadata
);
Параметры
[in] bstrXML
Xml-строка, содержащая документ метаданных модуля записи, с помощью которого инициализируется возвращенный объект IVssExamineWriterMetadata .
[out] ppMetadata
Переменная, получающая указатель интерфейса IVssExamineWriterMetadata на объект .
Возвращаемое значение
Приведенные здесь возвращаемые значения являются дополнением к обычным COM HRESULT, которые могут быть возвращены в любое время из функции.
Значение | Значение |
---|---|
|
Успешно возвращен указатель на интерфейс IVssExamineWriterMetadata . |
|
Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором. |
|
Один из параметров недопустим. |
|
Нехватка памяти или других системных ресурсов. |
|
XML-документ, переданный в параметре bstrXML , недопустим, то есть он либо не является правильно сформированной XML-строкой, либо не соответствует схеме. |
|
Непредвиденная ошибка. Код ошибки регистрируется в файле журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в 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 |