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

  • Статья

Метод GetRestoreSubcomponent возвращает указанный подкомпонент, связанный с заданным компонентом.

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

Синтаксис

HRESULT GetRestoreSubcomponent(
  [in]  UINT iComponent,
  [out] BSTR *pbstrLogicalPath,
  [out] BSTR *pbstrComponentName,
  [out] bool *pbRepair
);

Параметры

[in] iComponent

Индекс подкомпонента. Значение этого параметра является целым числом от 0 до n–1 включительно, где n — общее число подкомпонентов, связанных с данным компонентом. Значение n возвращается IVssComponent::GetRestoreSubcomponentCount.

[out] pbstrLogicalPath

Указатель на строку, содержащую логический путь к подкомпоненту. Логический путь не может быть пустым при работе с подкомпонентами.

[out] pbstrComponentName

Указатель на строку, содержащую имя подкомпонента. Строка не может быть пустой.

[out] pbRepair

Зарезервировано для последующего использования.

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

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

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

Комментарии

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

Требования

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

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

IVssComponent