IOpcRelationship::GetTargetUri-Methode (msopc.h)
Ruft den URI des Beziehungsziels ab.
Syntax
HRESULT GetTargetUri(
[out, retval] IUri **targetUri
);
Parameter
[out, retval] targetUri
Ein Zeiger auf die IUri-Schnittstelle des URI, der den URI des Ziels der Beziehung darstellt.
Wenn das Beziehungsziel intern ist, ist das Ziel ein Teil, und der URI des Ziels ist relativ zum URI des Quellteils.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der targetUri-Parameter ist NULL. |
Hinweise
Die endgültige Möglichkeit, einen Teil von Interesse zu finden, ist die Verwendung eines Beziehungstyps.
Die Suche nach einem Teil von Interesse erfordert mehrere Schritte. Ausführliche Informationen zum Suchen eines Teils finden Sie unter Teileübersicht und Suchen des Kerneigenschaftenteils.
Um zu bestimmen, ob das Ziel der Beziehung intern oder extern ist, rufen Sie die GetTargetUri-Methode auf.
Wenn das Beziehungsziel intern ist, ist das Ziel ein Teil.
Wenn das Beziehungsziel ein Teil ist, ist der URI in targetUri relativ zum URI der Beziehungsquelle.
Wenn das Beziehungsziel ein Teil ist, bilden Sie den Namen des Teils, indem Sie die IOpcUri::CombinePartUri-Methode aus dem IOpcUri-Schnittstellenzeiger aufrufen, der im sourceUri-Parameter der GetSourceUri-Methode empfangen wurde. Verwenden Sie den in targetUri empfangenen relativen URI als Eingabeparameter des IOpcUri::CombinePartUri-Aufrufs . Ein Beispiel finden Sie unter Auflösen eines Teilenamens aus einem Ziel-URI.
Weitere Informationen zu Beziehungen finden Sie unter Open Packaging Conventions Fundamentals und ecma-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).
Threadsicherheit
Das Packen von Objekten ist nicht threadsicher.
Weitere Informationen finden Sie in der Erste Schritte mit der Paketerstellungs-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
Externe Ressourcen
Erste Schritte mit der Verpackungs-API
Grundlagen offener Verpackungskonventionen
Übersichten
Referenz