IOpcRelationshipSet::CreateRelationship-Methode (msopc.h)

Artikel
03/04/2024

Erstellt ein Beziehungsobjekt, das eine angegebene Beziehung darstellt, und fügt dann dem Satz einen Zeiger auf die IOpcRelationship-Schnittstelle des Objekts hinzu.

Syntax

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

Parameter

[in] relationshipIdentifier

Ein eindeutiger Bezeichner der Beziehung, die als Beziehungsobjekt dargestellt werden soll. Um einen zufällig generierten Bezeichner zu verwenden, übergeben Sie NULL an diesen Parameter.

Gültige Bezeichner entsprechen den Einschränkungen für xsd:ID, die in Abschnitt 3.3.8 ID der W3C-Empfehlung, XML Schema Part 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID) dokumentiert sind.

[in] relationshipType

Der Beziehungstyp, der die Rolle der Beziehung definiert, die als Beziehungsobjekt dargestellt werden soll.

[in] targetUri

Ein URI für das Ziel der Beziehung, die als Beziehungsobjekt dargestellt werden soll.

Wenn der Wert in targetModeOPC_URI_TARGET_MODE_INTERNAL ist, ist target ein Teil, und der URI muss relativ zur Quelle der Beziehung sein.

Wenn der Wert in targetModeOPC_URI_TARGET_MODE_EXTERNAL ist, ist target eine Ressource außerhalb des Pakets, und der URI kann absolut oder relativ zum Speicherort des Pakets sein.

Weitere Informationen zum URI des Ziels einer Beziehung finden Sie unter OPC.

[in] targetMode

Ein Wert, der angibt, ob das Ziel der Beziehung, die als Beziehungsobjekt dargestellt werden soll, intern oder extern für das Paket ist.

[out, retval] relationship

Ein Zeiger auf die IOpcRelationship-Schnittstelle des Beziehungsobjekts, das die Beziehung darstellt.

Dieser Parameter kann NULL sein, wenn kein Zeiger auf das neue Objekt erforderlich ist.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode/-wert	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	Der im targetMode-Parameter übergebene Wert ist kein gültiger OPC_URI_TARGET_MODE Enumerationswert.
E_POINTER	Mindestens einer der Parameter relationshipType und targetUri ist NULL.
OPC_E_DUPLICATE_RELATIONSHIP 0x80510013	Im aktuellen Paket ist bereits eine Beziehung mit demselben Bezeichner vorhanden.
OPC_E_INVALID_RELATIONSHIP_ID 0x80510010	Das Id-Attribut einer Beziehung entspricht nicht den regeln, die im OPC angegeben sind.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	Der URI in targetUri ist absolut, und der Wert in targetMode ist OPC_URI_TARGET_MODE_INTERNAL. Der URI des Ziels muss relativ sein, wenn dieser Zielmodus angegeben wird.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	Das Target-Attribut einer Beziehung entspricht nicht den im OPC angegebenen Regeln.
OPC_E_INVALID_RELATIONSHIP_TYPE 0x80510011	Das Type-Attribut einer Beziehung entspricht nicht den im OPC angegebenen Regeln.
Fehler "Paketverbrauch"	Ein HRESULT-Fehlercode aus der Fehlergruppe Paketverbrauch.
Part-URI-Fehler	Ein HRESULT-Fehlercode aus der Part-URI-Fehlergruppe.

Hinweise

Wenn ein Beziehungsobjekt erstellt und dem Satz ein Zeiger darauf hinzugefügt wird, wird die beziehung, die es darstellt, gespeichert, wenn das Paket gespeichert wird.

Die IOpcRelationship-Schnittstelle ermöglicht den Zugriff auf Beziehungseigenschaften. Ausführliche Informationen zu diesen Eigenschaften finden Sie unter Übersicht über Beziehungen und IOpcRelationship.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h