IOpcUri::GetRelativeUri-Methode (msopc.h)

Bildet einen relativen URI für einen angegebenen Teil relativ zum URI, der durch das aktuelle OPC-URI-Objekt dargestellt wird.

Syntax

HRESULT GetRelativeUri(
  [in]          IOpcPartUri *targetPartUri,
  [out, retval] IUri        **relativeUri
);

[in] targetPartUri

Ein Zeiger auf die IOpcPartUri-Schnittstelle des Part-URI-Objekts, der den Teilenamen darstellt, aus dem der relative URI gebildet wird.

[out, retval] relativeUri

Ein Zeiger auf die IUri-Schnittstelle des URI des Teils relativ zum aktuellen OPC-URI-Objekt.

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

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Mindestens einer der Parameter targetPartUri und relativePartUri ist NULL.
Fehler der CreateUri-Funktion	Ein HRESULT-Fehlercode aus der CreateUri-Funktion .
WinINet-Fehler	Ein HRESULT-Fehlercode aus einer WinINet-API .

Beispiel für Eingabe und Ausgabe:

Eingabe-IOpcPartUri stellt dar	Aktueller IOpcUri stellt dar	Zurückgegebener relativer IUri stellt dar
/mydoc/markup/page.xml	/mydoc/markup/picture.jpg	picture.jpg
/mydoc/markup/page.xml	/mydoc/picture.jpg	.. /picture.jpg
/mydoc/markup/page.xml	/mydoc/images/pictures.jpg	.. /images/pictures.jpg

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.

Das Packen von Objekten ist nicht threadsicher.

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