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

Статья
08/25/2023

Возвращает имя части "Связи", в котором хранятся связи с исходным URI, представленным текущим объектом URI OPC.

Синтаксис

HRESULT GetRelationshipsPartUri(
  [out, retval] IOpcPartUri **relationshipPartUri
);

Параметры

[out, retval] relationshipPartUri

Указатель на интерфейс IOpcPartUri объекта URI части, который представляет имя части части Relationships. Исходный URI связей, хранящихся в этой части "Связи", представлен текущим объектом URI OPC.

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

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

Возвращаемый код или значение	Описание
S_OK	Метод выполнен успешно.
E_POINTER	Параметр relationshipPartUri имеет значение NULL.
OPC_E_NONCONFORMING_URI 0x80510001	Текущий IOpcUri представляет часть Связей и не может быть источником каких-либо связей.
Ошибка функции CreateUri	Код ошибки HRESULT из функции CreateUri .
Ошибка WinINet	Код ошибки HRESULT из API WinINet .

OPC URI	Имя части "Связи"	Возвращаемое значение
/mydoc/images/picture.jpg	/mydoc/images/_rels/picture.jpg.rels	S_OK
/	/_rels/.rels	S_OK
/mydoc/images/_rels/picture.jpg.rels	Не определено.	OPC_E_NONCONFORMING_URI

Поведение и производительность этого метода одинакова во всех поддерживаемых версиях 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