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


Метод IVssWMDependency::GetLogicalPath (vswriter.h)

Метод GetLogicalPath извлекает логический путь компонента, от которого зависит текущий компонент в явной зависимости компонента записи.

Синтаксис

HRESULT GetLogicalPath(
  [out] BSTR *pbstrLogicalPath
);

Параметры

[out] pbstrLogicalPath

Адрес переменной, выделенной вызывающей стороной, которая получает строку символов, завершающуюся null, содержащую логический путь к компоненту, от который зависит текущий компонент.

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

Этот метод может возвращать одно из этих значений.

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

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

Комментарии

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

Зависимость не указывает порядок предпочтений между компонентом с задокументированных зависимостей и компонентами, от которые он зависит. Зависимость просто указывает на то, что компонент и компоненты, от которые он зависит, всегда должны архивироваться или восстанавливаться вместе.

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

При наличии нескольких экземпляров класса записи необходимо использовать логический путь и сведения о имени компонента, чтобы определить экземпляр, управляющий компонентом, от которых зависит текущий компонент.

Требования

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

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

IVssWMComponent::GetDependency

IVssWMDependency

IVssWMDependency::GetComponentName

IVssWMDependency::GetWriterId