Método IOpcRelationshipSet::CreateRelationship (msopc.h)

Artículo
02/29/2024

Crea un objeto de relación que representa una relación especificada y, a continuación, agrega al conjunto de un puntero a la interfaz IOpcRelationship del objeto.

Sintaxis

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

Parámetros

[in] relationshipIdentifier

Identificador único de la relación que se va a representar como el objeto de relación. Para usar un identificador generado aleatoriamente, pase NULL a este parámetro.

Los identificadores válidos cumplen las restricciones para xsd:ID, que se documentan en la sección 3.3.8 del identificador de la recomendación W3C, esquema XML Parte 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID).

[in] relationshipType

Tipo de relación que define el rol de la relación que se va a representar como el objeto de relación.

[in] targetUri

URI para el destino de la relación que se va a representar como el objeto de relación.

Si el valor de targetMode es OPC_URI_TARGET_MODE_INTERNAL, el destino es una parte y el URI debe ser relativo al origen de la relación.

Si el valor de targetMode es OPC_URI_TARGET_MODE_EXTERNAL, el destino es un recurso fuera del paquete y el URI puede ser absoluto o relativo a la ubicación del paquete.

Para obtener más información sobre el URI del destino de una relación, consulte OPC.

[in] targetMode

Valor que indica si el destino de la relación que se va a representar como el objeto de relación es interno o externo al paquete.

[out, retval] relationship

Puntero a la interfaz IOpcRelationship del objeto de relación que representa la relación.

Este parámetro puede ser NULL si no se necesita un puntero al nuevo objeto.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código o valor devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	El valor pasado en el parámetro targetMode no es un valor de enumeración OPC_URI_TARGET_MODE válido.
E_POINTER	Al menos uno de los parámetros relationshipType y targetUri es NULL.
OPC_E_DUPLICATE_RELATIONSHIP 0x80510013	Ya existe una relación con el mismo identificador en el paquete actual.
OPC_E_INVALID_RELATIONSHIP_ID 0x80510010	El atributo Id de una relación no se ajusta a las reglas especificadas en el OPC.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	El URI de targetUri es absoluto y el valor de targetMode es OPC_URI_TARGET_MODE_INTERNAL. El URI del destino debe ser relativo cuando se especifica este modo de destino.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	El atributo Target de una relación no se ajusta a las reglas especificadas en el OPC.
OPC_E_INVALID_RELATIONSHIP_TYPE 0x80510011	El atributo Type de una relación no se ajusta a las reglas especificadas en el OPC.
Error de consumo de paquetes	Código de error HRESULT del grupo de errores de consumo de paquetes.
Error de URI de parte	Código de error HRESULT del grupo de errores de URI de parte.

Comentarios

Cuando se crea un objeto de relación y se agrega un puntero al conjunto, la relación que representa se guarda cuando se guarda el paquete.

La interfaz IOpcRelationship proporciona acceso a las propiedades de relación. Para obtener más información sobre estas propiedades, consulte Información general de relaciones e IOpcRelationship.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para más información, consulte la Introducción con la API de empaquetado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h