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


Метод IOpcUri::GetRelativeUri (msopc.h)

Формирует относительный URI для указанной части относительно URI, представленного текущим объектом URI OPC.

Синтаксис

HRESULT GetRelativeUri(
  [in]          IOpcPartUri *targetPartUri,
  [out, retval] IUri        **relativeUri
);

Параметры

[in] targetPartUri

Указатель на интерфейс IOpcPartUri объекта URI части, представляющего имя части, из которой формируется относительный URI.

[out, retval] relativeUri

Указатель на интерфейс IUri URI части относительно текущего объекта URI OPC.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
Метод выполнен успешно.
E_POINTER
По крайней мере один из параметров targetPartUri и relativePartUri имеет значение NULL.
Ошибка функции CreateUri
Код ошибки HRESULT из функции CreateUri .
Ошибка WinINet
Код ошибки HRESULT из API WinINet .

Комментарии

Примеры входных и выходных данных:

Входной IOpcPartUri представляет Текущий IOpcUri представляет Возвращаемый относительный код ресурса (IURI ) представляет
/mydoc/markup/page.xml /mydoc/markup/picture.jpg picture.jpg
/mydoc/markup/page.xml /mydoc/picture.jpg .. /picture.jpg
/mydoc/markup/page.xml /mydoc/images/pictures.jpg .. /images/pictures.jpg
 

Поддержка в предыдущих версиях Windows

Поведение и производительность этого метода одинакова во всех поддерживаемых версиях Windows. Дополнительные сведения см. в разделах начало работы с ПОМОЩЬЮ API упаковки и Обновление платформы для Windows Vista.

Потокобезопасность

Объекты упаковки не являются потокобезопасны.

Дополнительные сведения см. в начало работы с API упаковки.

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header msopc.h

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

начало работы с помощью API упаковки

IOpcUri

Разделы общих сведений

Справочник по API упаковки

Примеры API упаковки

Ошибки упаковки

Обновление платформы для Windows Vista

Справочные материалы