IOpcFactory::CreatePartUri-Methode (msopc.h)

Artikel
03/06/2024

Erstellt ein Part-URI-Objekt, das einen Teilenamen darstellt.

Syntax

HRESULT CreatePartUri(
  [in]          LPCWSTR     pwzUri,
  [out, retval] IOpcPartUri **partUri
);

Parameter

[in] pwzUri

Ein URI, der den Speicherort eines Teils relativ zum Stamm des Pakets darstellt, in dem es enthalten ist.

[out, retval] partUri

Ein Zeiger auf die IOpcPartUri-Schnittstelle des Part-URI-Objekts. Dieses Objekt stellt den Teilenamen dar, der von dem in pwzUri übergebenen URI abgeleitet ist.

Teilenamen müssen der im OPC angegebenen Syntax entsprechen.

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	Mindestens einer der Parameter pwzUri und partUri ist NULL.
OPC_E_NONCONFORMING_URI 0x80510001	Ein Teilename darf nicht die leere Zeichenfolge "" sein.
OPC_E_NONCONFORMING_URI 0x80510001	Ein Teilename darf kein "/" sein.
OPC_E_NONCONFORMING_URI 0x80510001	Ein Teilename kann nicht mit "//" beginnen.
OPC_E_NONCONFORMING_URI 0x80510001	Ein Teilename kann nicht mit einem "/" enden.
OPC_E_NONCONFORMING_URI 0x80510001	Ein Teilename kann nicht mit einem "." enden.
OPC_E_NONCONFORMING_URI 0x80510001	Ein Teilename darf keine Segmente aufweisen, die mit einem "." enden.
OPC_E_NONCONFORMING_URI 0x80510001	Ein Teilename darf keine Fragmentkomponente aufweisen. Einer Fragmentkomponente wird ein "#"-Zeichen vorangestellt, wie in RFC 3986: Generische URI-Syntax beschrieben.
OPC_E_NONCONFORMING_URI 0x80510001	Ein Teilename kann nicht der Name eines Beziehungsteils sein, der einen anderen Beziehungsteil als Quelle der darin enthaltenen Beziehungen angibt.
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	Ein Teilename darf kein absoluter URI sein. Ein absoluter URI beginnt mit einer Schemakomponente gefolgt von einem ":", wie in RFC 3986: URI Generic Syntax beschrieben.
Fehler der CreateUri-Funktion	Ein HRESULT-Fehlercode aus der CreateUri-Funktion .
WinINet-Fehler	Ein HRESULT-Fehlercode aus einer WinINet-API .

Hinweise

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