Метод IOpcRelationshipSet::CreateRelationship (msopc.h)

Статья
03/05/2024

Создает объект связи, представляющий указанную связь, а затем добавляет в набор указатель на интерфейс IOpcRelationship объекта.

Синтаксис

HRESULT CreateRelationship(
  [in]          LPCWSTR             relationshipIdentifier,
  [in]          LPCWSTR             relationshipType,
  [in]          IUri                *targetUri,
  [in]          OPC_URI_TARGET_MODE targetMode,
  [out, retval] IOpcRelationship    **relationship
);

Параметры

[in] relationshipIdentifier

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

Допустимые идентификаторы соответствуют ограничениям для xsd:ID, которые описаны в разделе 3.3.8 ИДЕНТИФИКАТОР рекомендации W3C, xml schema Part 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID).

[in] relationshipType

Тип связи, определяющий роль связи, которая будет представлена в качестве объекта связи.

[in] targetUri

Универсальный код ресурса (URI) для целевого объекта связи, который будет представлен как объект связи.

Если значение в targetMode равно OPC_URI_TARGET_MODE_INTERNAL, target является частью, а универсальный код ресурса (URI) должен быть относительно источника связи.

Если значение в targetMode равно OPC_URI_TARGET_MODE_EXTERNAL, target является ресурсом за пределами пакета, а универсальный код ресурса (URI) может быть абсолютным или относительным к расположению пакета.

Дополнительные сведения о URI целевого объекта связи см. в разделе OPC.

[in] targetMode

Значение типа , указывающее, является ли целевой объект связи, представленный в качестве объекта связи, внутренним или внешним по отношению к пакету.

[out, retval] relationship

Указатель на интерфейс IOpcRelationship объекта связи, представляющего связь.

Этот параметр может иметь значение NULL , если указатель на новый объект не требуется.

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

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

Возвращаемый код/значение	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Значение, переданное в параметре targetMode , не является допустимым значением перечисления OPC_URI_TARGET_MODE .
E_POINTER	Хотя бы один из параметров relationshipType и targetUri имеет значение NULL.
OPC_E_DUPLICATE_RELATIONSHIP 0x80510013	Связь с тем же идентификатором уже существует в текущем пакете.
OPC_E_INVALID_RELATIONSHIP_ID 0x80510010	Атрибут Id связи не соответствует правилам, указанным в OPC.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	Универсальный код ресурса (URI) в targetUri является абсолютным, а значение в targetMode — OPC_URI_TARGET_MODE_INTERNAL. При указании этого целевого режима URI целевого объекта должен быть относительным.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	Атрибут Target связи не соответствует правилам, указанным в OPC.
OPC_E_INVALID_RELATIONSHIP_TYPE 0x80510011	Атрибут Type связи не соответствует правилам, указанным в OPC.
Ошибка потребления пакета	Код ошибки HRESULT из группы ошибок потребления пакетов.
Ошибка URI части	Код ошибки HRESULT из группы ошибок URI части.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	msopc.h