Metode IOpcUri::CombinePartUri (msopc.h)

Artikel
08/25/2023

Membentuk nama bagian dari bagian yang dirujuk oleh URI relatif yang ditentukan. URI relatif yang ditentukan dari bagian diselesaikan terhadap URI yang direpresentasikan sebagai objek URI OPC saat ini.

Sintaks

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

Parameter

[in] relativeUri

Penunjuk ke antarmuka IUri dari URI relatif dari bagian tersebut.

Untuk membentuk objek URI bagian yang mewakili nama bagian, URI input ini diselesaikan terhadap URI yang direpresentasikan sebagai objek URI OPC saat ini. Oleh karena itu, URI input harus relatif terhadap URI yang diwakili oleh objek URI OPC saat ini.

URI ini dapat mencakup komponen fragmen; namun, fragmen akan diabaikan dan tidak akan disertakan dalam nama bagian yang akan dibentuk. Komponen fragmen didahului oleh '#', seperti yang dijelaskan dalam RFC 3986: URI Generic Syntax.

[out, retval] combinedUri

Penunjuk ke antarmuka IOpcPartUri dari objek URI bagian yang mewakili nama bagian.

Objek URI bagian dibentuk dengan menyelesaikan URI relatif dalam relativeUri terhadap URI yang diwakili oleh objek URI OPC saat ini.

Mengembalikan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Mengembalikan kode/nilai	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Fungsi CoInternetCombineUrl mengembalikan ukuran yang tidak valid.
E_POINTER	Setidaknya salah satu parameter relativeUri, dan combinedUri adalah NULL.
E_UNEXPECTED	Ukuran buffer yang diperlukan oleh fungsi CoInternetCombineUrl berubah secara tak terduga.
OPC_E_NONCONFORMING_URI 0x80510001	Nama bagian tidak sesuai dengan aturan yang ditentukan dalam standar OPC .
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	Nama bagian tidak boleh menjadi URI absolut. URI absolut dimulai dengan komponen skema diikuti oleh ":", seperti yang dijelaskan dalam RFC 3986: URI Generic Syntax.
Kesalahan fungsi CoInternetCombineUrl	Kode kesalahan HRESULT dari fungsi CoInternetCombineUrl .
Kesalahan fungsi CreateUri	Kode kesalahan HRESULT dari fungsi CreateUri .
Kesalahan WinINet	Kode kesalahan HRESULT dari API WinINet .

Keterangan

Contoh input dan output:

IUri relatif input	IOpcUri Saat Ini	IOpcPartUri Yang Dibentuk
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

Untuk informasi tentang cara menggunakan metode ini untuk membantu mengatasi nama bagian, lihat Menyelesaikan Nama Bagian dari URI Target.

Dukungan pada Versi Windows Sebelumnya

Perilaku dan performa metode ini sama pada semua versi Windows yang didukung. Untuk informasi selengkapnya, lihat Mulai menggunakan API Kemasan, dan Pembaruan Platform untuk Windows Vista.

Keamanan Thread

Objek pengemasan tidak aman untuk rangkaian.

Untuk informasi selengkapnya, lihat Memulai API Kemasan.

Persyaratan


Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	msopc.h