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


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

Метод GetNewTarget возвращает новые расположения восстановления файлов для выбранного компонента или набора компонентов. (Сведения о выборе компонентов см. в статье Работа с возможностью выбора и логическими путями .)

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

Синтаксис

HRESULT GetNewTarget(
  [in]  UINT           iNewTarget,
  [out] IVssWMFiledesc **ppFiledesc
);

Параметры

[in] iNewTarget

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

[out] ppFiledesc

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

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

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

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

Комментарии

Новыми целевыми объектами, возвращаемыми GetNewTarget , могут быть не только файлы в текущем компоненте, но и файлы в любом из его неизбираемых подкомпонентов.

Требования

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

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

IVssComponent

IVssComponent::GetNewTargetCount