IOpcUri::GetRelationshipsPartUri-Methode (msopc.h)

Artikel
03/04/2024

Ruft den Teilenamen des Relationships-Teils ab, in dem Beziehungen gespeichert werden, für die der Quell-URI durch das aktuelle OPC-URI-Objekt dargestellt wird.

Syntax

HRESULT GetRelationshipsPartUri(
  [out, retval] IOpcPartUri **relationshipPartUri
);

Parameter

[out, retval] relationshipPartUri

Ein Zeiger auf die IOpcPartUri-Schnittstelle des Part-URI-Objekts, das den Teilenamen des Teils "Relationships" darstellt. Der Quell-URI der in diesem Beziehungsteil gespeicherten Beziehungen wird durch das aktuelle OPC-URI-Objekt dargestellt.

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_POINTER	Der parameter relationshipPartUri ist NULL.
OPC_E_NONCONFORMING_URI 0x80510001	Der aktuelle IOpcUri stellt einen Beziehungsteil dar und kann keine Beziehungsquelle sein.
Fehler der CreateUri-Funktion	Ein HRESULT-Fehlercode aus der CreateUri-Funktion .
WinINet-Fehler	Ein HRESULT-Fehlercode aus einer WinINet-API .

Hinweise

In der folgenden Tabelle sind Beziehungspart-URIs für einige OPC-URIs aufgeführt.

OPC-URI	Beziehungsteilname	Rückgabewert
/mydoc/images/picture.jpg	/mydoc/images/_rels/picture.jpg.rels	S_OK
/	/_rels/.rels	S_OK
/mydoc/images/_rels/picture.jpg.rels	Nicht definiert	OPC_E_NONCONFORMING_URI

Unterstützung für frühere Windows-Versionen

Das Verhalten und die Leistung dieser Methode ist in allen unterstützten Windows-Versionen identisch. Weitere Informationen finden Sie unter Erste Schritte mit der Verpackungs-API und Platform Update für Windows Vista.

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, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h