Метод IOpcRelationship::GetTargetUri (msopc.h)
Возвращает универсальный код ресурса (URI) целевого объекта связи.
Синтаксис
HRESULT GetTargetUri(
[out, retval] IUri **targetUri
);
Параметры
[out, retval] targetUri
Указатель на интерфейс IUri универсального кода ресурса (URI), представляющий универсальный код ресурса (URI) целевого объекта связи.
Если целевой объект связи является внутренним, целевой объект является частью, а URI целевого объекта — относительно URI исходной части.
Возвращаемое значение
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
|
Параметр targetUri имеет значение NULL. |
Комментарии
Окончательный способ найти интересующую вас часть — использовать тип связи.
Поиск интересующей вас части требует нескольких шагов. Подробные сведения о поиске части см. в разделах Общие сведения о компонентах и Поиск части основных свойств.
Чтобы определить, является ли целевой объект связи внутренним или внешним, вызовите метод GetTargetUri .
Если целевой объект связи является внутренним, целевой объект является частью.
Если целевой объект связи является частью, универсальный код ресурса (URI) в targetUri относительно URI источника связи.
Если целевой объект связи является частью, создайте имя части, вызвав метод IOpcUri::CombinePartUri из указателя интерфейса IOpcUri , полученного в параметре sourceUri метода GetSourceUri . Используйте относительный URI, полученный в targetUri , в качестве входного параметра вызова IOpcUri::CombinePartUri . Пример см. в разделе Разрешение имени части из целевого URI.
Дополнительные сведения о связях см. в разделах Open Packaging Conventions Fundamentals и ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).
Потокобезопасность
Объекты упаковки не являются потокобезопасны.
Дополнительные сведения см. в статье начало работы с помощью API упаковки.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | msopc.h |
См. также раздел
Внешние ресурсы
начало работы с помощью API упаковки
Основы открытых соглашений об упаковке
Разделы общих сведений
Справочные материалы