Share via

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

  • Статья

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

Синтаксис

HRESULT GetComponentName(
  BSTR *pbstrComponentName
);

Параметры

pbstrComponentName

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

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

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

Значение Значение
S_OK
 Успешно возвращено имя компонента, от который зависит текущий компонент.
S_FALSE
 Не удается найти модуль записи, который управляет компонентом, от который зависит текущий компонент.
E_INVALIDARG
 Указатель pbstrComponentName указывает на нераспределенный объем памяти.
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::GetLogicalPath

IVssWMDependency::GetWriterId