Метод IOpcFactory::CreatePartUri (msopc.h)

Статья
03/08/2023

Создает объект URI части, представляющий имя части.

Синтаксис

HRESULT CreatePartUri(
  [in]          LPCWSTR     pwzUri,
  [out, retval] IOpcPartUri **partUri
);

Параметры

[in] pwzUri

Универсальный код ресурса (URI), представляющий расположение части относительно корня пакета, содержащего его.

[out, retval] partUri

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

Имена частей должны соответствовать синтаксису, указанному в OPC.

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

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

Возвращаемый код или значение	Описание
S_OK	Метод выполнен успешно.
E_POINTER	По крайней мере один из параметров pwzUri и partUri имеет значение NULL.
OPC_E_NONCONFORMING_URI 0x80510001	Имя части не может быть пустой строкой "".
OPC_E_NONCONFORMING_URI 0x80510001	Имя части не может быть "/".
OPC_E_NONCONFORMING_URI 0x80510001	Имя части не может начинаться с "/".
OPC_E_NONCONFORMING_URI 0x80510001	Имя части не может заканчиваться на "/".
OPC_E_NONCONFORMING_URI 0x80510001	Имя части не может заканчиваться на ".".
OPC_E_NONCONFORMING_URI 0x80510001	Имя части не может содержать сегменты, заканчивающиеся на ".".
OPC_E_NONCONFORMING_URI 0x80510001	Имя части не может содержать компонент фрагмента. Компоненту фрагмента предшествует символ #, как описано в документе RFC 3986: универсальный синтаксис URI.
OPC_E_NONCONFORMING_URI 0x80510001	Имя части не может быть именем части "Связи", указывающей другую часть "Связи" в качестве источника содержащихся в ней связей.
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	Имя части не может быть абсолютным универсальным кодом ресурса (URI). Абсолютный URI начинается с компонента схемы, за которым следует ":", как описано в rfc 3986: универсальный синтаксис URI.
Ошибка функции CreateUri	Код ошибки HRESULT из функции CreateUri .
Ошибка WinINet	Код ошибки HRESULT из API WinINet .

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