Метод IOpcPartUri::GetSourceUri (msopc.h)

Статья
08/25/2023

Возвращает исходный универсальный код ресурса (URI) связей, хранящихся в части "Связи". Объект URI текущей части представляет имя части этой части Relationships.

Синтаксис

HRESULT GetSourceUri(
  [out, retval] IOpcUri **sourceUri
);

Параметры

[out, retval] sourceUri

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

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

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

Возвращаемый код/значение	Описание
S_OK	Метод выполнен успешно.
E_POINTER	Параметр sourceUri имеет значение NULL.
OPC_E_RELATIONSHIP_URI_REQUIRED 0x80510003	Имя части части "Связи" является обязательным, но имя части не является именем части "Связи". Дополнительные сведения об именах частей связей см. в разделе OPC.
Ошибка функции CreateUri	Код ошибки HRESULT из функции CreateUri .
Ошибка WinINet	Код ошибки HRESULT из API WinINet .

Если объект URI текущей части представляет имя части "Связи", в котором хранятся связи пакетов ("/_rels/.rels"), объект URI OPC, возвращаемый в sourceUri , будет представлять корень пакета ("/").

Если текущий объект URI части не является именем части "Связи", этот метод завершается ошибкой OPC_E_RELATIONSHIP_URI_REQUIRED . Синтаксис имен частей связи указан в OPC.

В следующей таблице показаны возможные URI текущей части и исходный URI, которые будут возвращены этим методом.

URI текущей части	Описание URI текущей части	URI источника	Описание исходного URI	Возвращаемое значение
/mydoc/_rels/picture.jpg.rels	Имя части части "Связи"	/mydoc/picture.jpg	Имя части части, являющейся источником связей, хранящихся в части "Связи", представленной объектом URI текущей части	S_OK
/_rels/.rels	Имя части части "Связи"	/	Корень пакета; источник связей, хранящихся в части "Связи", представленной объектом URI текущей части	S_OK
/mydoc/image/chart1.jpg	Имя части, которая не является частью Связей	Не определено	Не определено	OPC_E_RELATIONSHIP_URI_REQUIRED
/_rels/a.jpg	Имя части, которая не является частью Связей	Не определено	Не определено	OPC_E_RELATIONSHIP_URI_REQUIRED

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

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

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

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

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

Требования

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