IOpcUri::CombinePartUri-Methode (msopc.h)

Artikel
10/26/2023

Bildet den Teilenamen des Teils, auf den durch den angegebenen relativen URI verwiesen wird. Der angegebene relative URI des Teils wird für den URI aufgelöst, der als aktuelles OPC-URI-Objekt dargestellt wird.

Syntax

HRESULT CombinePartUri(
  [in]          IUri        *relativeUri,
  [out, retval] IOpcPartUri **combinedUri
);

Parameter

[in] relativeUri

Ein Zeiger auf die IUri-Schnittstelle des relativen URI des Teils.

Um das Part-URI-Objekt zu bilden, das den Teilenamen darstellt, wird dieser Eingabe-URI für den URI aufgelöst, der als aktuelles OPC-URI-Objekt dargestellt wird. Daher muss der Eingabe-URI relativ zum URI sein, der durch das aktuelle OPC-URI-Objekt dargestellt wird.

Dieser URI kann eine Fragmentkomponente enthalten. Das Fragment wird jedoch ignoriert und nicht im Namen des zu bildenden Teils enthalten. Einer Fragmentkomponente wird eine "#" vorangestellt, wie in RFC 3986: Generische URI-Syntax beschrieben.

[out, retval] combinedUri

Ein Zeiger auf die IOpcPartUri-Schnittstelle des Part-URI-Objekts, das den Teilenamen darstellt.

Das Part-URI-Objekt wird gebildet, indem der relative URI in relativeUri für den URI aufgelöst wird, der durch das aktuelle OPC-URI-Objekt dargestellt wird.

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_FAIL	Die CoInternetCombineUrl-Funktion hat eine ungültige Größe zurückgegeben.
E_POINTER	Mindestens einer der Parameter relativeUri und combinedUri ist NULL.
E_UNEXPECTED	Die Größe des Puffers, der für die CoInternetCombineUrl-Funktion erforderlich ist, hat sich unerwartet geändert.
OPC_E_NONCONFORMING_URI 0x80510001	Der Teilename entspricht nicht den regeln, die in den OPC-Standards angegeben sind.
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	Ein Teilname kann kein absoluter URI sein. Ein absoluter URI beginnt mit einer Schemakomponente gefolgt von einem ":", wie in RFC 3986: URI Generic Syntax beschrieben.
Fehler der CoInternetCombineUrl-Funktion	Ein HRESULT-Fehlercode aus der CoInternetCombineUrl-Funktion .
Fehler bei der CreateUri-Funktion	Ein HRESULT-Fehlercode aus der CreateUri-Funktion .
WinINet-Fehler	Ein HRESULT-Fehlercode aus einer WinINet-API .

Hinweise

Beispiel für Eingabe und Ausgabe:

Relativer IURI der Eingabe	Aktueller IOpcUri	Formatierter IOpcPartUri
picture.jpg	/mydoc/markup/page.xml	/mydoc/markup/picture.jpg
.. /picture.jpg	/mydoc/markup/page.xml	/mydoc/picture.jpg
.. /.. /images/picture.jpg	/mydoc/page.xml	/images/picture.jpg

Informationen zur Verwendung dieser Methode zum Auflösen eines Teilenamens finden Sie unter Auflösen eines Teilenamens aus einem Ziel-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 Paketerstellungs-API und Plattformupdate für Windows Vista.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie in der Erste Schritte mit der Paketerstellungs-API.

Anforderungen


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