Metode IOpcFactory::CreatePartUri (msopc.h)

Membuat objek URI bagian yang mewakili nama bagian.

Sintaks

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

Parameter

[in] pwzUri

URI yang mewakili lokasi bagian yang relatif terhadap akar paket yang berisinya.

[out, retval] partUri

Penunjuk ke antarmuka IOpcPartUri dari objek URI bagian. Objek ini mewakili nama bagian yang berasal dari URI yang diteruskan dalam pwzUri.

Nama bagian harus sesuai dengan sintaks yang ditentukan dalam OPC.

Nilai kembali

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_POINTER
Setidaknya salah satu parameter pwzUri dan partUri adalah NULL.
OPC_E_NONCONFORMING_URI
0x80510001
Nama bagian tidak boleh berupa string kosong "".
OPC_E_NONCONFORMING_URI
0x80510001
Nama bagian tidak boleh '/'.
OPC_E_NONCONFORMING_URI
0x80510001
Nama bagian tidak dapat dimulai dengan "//".
OPC_E_NONCONFORMING_URI
0x80510001
Nama bagian tidak dapat diakhir dengan '/'.
OPC_E_NONCONFORMING_URI
0x80510001
Nama bagian tidak dapat diakhir dengan '.'.
OPC_E_NONCONFORMING_URI
0x80510001
Nama bagian tidak boleh memiliki segmen apa pun yang diakhir dengan '.'.
OPC_E_NONCONFORMING_URI
0x80510001
Nama bagian tidak boleh memiliki komponen fragmen. Komponen fragmen didahului oleh karakter '#', seperti yang dijelaskan dalam RFC 3986: URI Generic Syntax.
OPC_E_NONCONFORMING_URI
0x80510001
Nama bagian tidak boleh berupa nama bagian Hubungan yang menunjukkan bagian Hubungan lain sebagai sumber hubungan yang terkandung di dalamnya.
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 CreateUri
Kode kesalahan HRESULT dari fungsi CreateUri .
Kesalahan WinINet
Kode kesalahan HRESULT dari API WinINet .

Keterangan

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

Persyaratan Nilai
Klien minimum yang didukung Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header msopc.h

Lihat juga

CreateUri

ECMA-376 OpenXML

Sumber Daya Eksternal

Memulai API Kemasan

IOpcFactory

Gambaran Umum

Panduan Pemrograman API Pengemasan

Referensi API Pengemasan

Sampel API Pengemasan

Kesalahan Pengemasan

Gambaran Umum Bagian

Pembaruan Platform untuk Windows Vista

RFC 3986: Sintaksis Generik URI

Referensi