IOpcRelationshipSet::GetRelationship-Methode (msopc.h)

Ruft ein Beziehungsobjekt aus dem Satz ab, das eine angegebene Beziehung darstellt.

Syntax

HRESULT GetRelationship(
  [in]          LPCWSTR          relationshipIdentifier,
  [out, retval] IOpcRelationship **relationship
);

Parameter

[in] relationshipIdentifier

Der eindeutige Bezeichner einer Beziehung.

[out, retval] relationship

Ein Zeiger auf die IOpcRelationship-Schnittstelle des Beziehungsobjekts, das die Beziehung darstellt, die den angegebenen Bezeichner aufweist.

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 Beziehungsparameter ist NULL.
OPC_E_NO_SUCH_RELATIONSHIP
0x80510048
Die angegebene Beziehung ist nicht vorhanden.
Fehler "Paketverbrauch"
Ein HRESULT-Fehlercode aus der Fehlergruppe Paketverbrauch.
Part-URI-Fehler
Ein HRESULT-Fehlercode aus der Part-URI-Fehlergruppe.

Hinweise

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

Weitere Informationen

Erste Schritte mit der Verpackungs-API

IOpcRelationshipSet

Übersichten

Verpackungs-API-Referenz

Beispiele für die Paket-API

Paketerstellungsfehler

Referenz

Übersicht über Beziehungen