Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Erstellt ein Teil-URI-Objekt, das einen Teilnamen darstellt.
Syntax
HRESULT CreatePartUri(
[in] LPCWSTR pwzUri,
[out, retval] IOpcPartUri **partUri
);
Die Parameter
[in] pwzUri
Ein URI, der den Speicherort eines Teils relativ zum Stamm des Pakets darstellt, das es enthält.
[out, retval] partUri
Ein Zeiger auf die IOpcPartUri-Schnittstelle des Part-URI-Objekts. Dieses Objekt stellt den Teilnamen dar, der vom in pwzUri übergebenen URI abgeleitet wurde.
Teilenamen müssen der im OPC angegebenen Syntax entsprechen.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.
| Zurückgeben von Code/Wert | Description |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Mindestens einer der PwzUri - und partUri-Parameter ist NULL. |
|
Ein Teilname darf nicht die leere Zeichenfolge "" sein. |
|
Ein Teilname darf kein '/' sein. |
|
Ein Teilname kann nicht mit "//" beginnen. |
|
Ein Teilname kann nicht mit einem "/" enden. |
|
Ein Teilname kann nicht mit einem '.' enden. |
|
Ein Teilname darf keine Segmente aufweisen, die mit einem "." enden. |
|
Ein Teilname darf keine Fragmentkomponente aufweisen. Einer Fragmentkomponente wird ein "#"-Zeichen vorangestellt, wie in RFC 3986: URI Generic Syntax beschrieben. |
|
Ein Teilname darf nicht der Name eines Beziehungsteils sein, der einen anderen Beziehungsteil als Quelle der darin enthaltenen Beziehungen angibt. |
|
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. |
|
Ein HRESULT-Fehlercode aus der CreateUri-Funktion . |
|
Ein HRESULT-Fehlercode aus einer WinINet-API . |
Bemerkungen
Unterstützung für frühere Windows-Versionen
Das Verhalten und die Leistung dieser Methode sind in allen unterstützten Windows-Versionen identisch. Weitere Informationen finden Sie unter "Erste Schritte mit der Verpackungs-API" und " Plattformupdate für Windows Vista".Threadsicherheit
Das Verpacken von Objekten ist nicht threadsicher.
Weitere Informationen finden Sie unter " Erste Schritte mit der Verpackungs-API".
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [nur Desktop-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Fenster |
| Header | msopc.h |
Siehe auch
Externe Ressourcen
Erste Schritte mit der Verpackungs-API
Übersichten
Programmierhandbuch für das Packen von API
Plattformupdate für Windows Vista
RFC 3986: Generische URI-Syntax
Referenz