Metode IXpsOMObjectFactory::CreateDocumentStructureResource (xpsobjectmodel.h)

Artikel
03/15/2023

Membuat antarmuka IXpsOMDocumentStructureResource , yang menyediakan akses ke aliran sumber daya struktur dokumen.

Sintaks

HRESULT CreateDocumentStructureResource(
  [in]          IStream                         *acquiredStream,
  [in]          IOpcPartUri                     *partUri,
  [out, retval] IXpsOMDocumentStructureResource **documentStructureResource
);

Parameter

[in] acquiredStream

Antarmuka IStream baca-saja yang akan dikaitkan dengan sumber daya ini. Parameter ini tidak boleh NULL.

Penting Perlakukan aliran ini sebagai objek apartemen Single-Threaded (STA); jangan masukkan kembali.

[in] partUri

Antarmuka IOpcPartUri yang berisi nama bagian yang akan ditetapkan ke sumber daya ini. Parameter ini tidak boleh NULL.

[out, retval] documentStructureResource

Penunjuk ke antarmuka IXpsOMDocumentStructureResource baru.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk informasi tentang nilai pengembalian API dokumen XPS yang tidak tercantum dalam tabel ini, lihat Kesalahan Dokumen XPS.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	acquiredStream, partUri, atau documentStructureResource adalah NULL.

Keterangan

Bagian DocumentStructure dari dokumen XPS berisi kerangka dokumen, yang, dengan bagian StoryFragments, menentukan urutan baca setiap elemen yang muncul di halaman tetap dokumen. Antarmuka ini memungkinkan program untuk membaca konten XML dari bagian DocumentStructure dan juga untuk mengganti konten XML dari bagian DocumentStructure.

Bagian DocumentStructure berisi kerangka kerja dokumen dan kerangka kerja yang menjelaskan urutan membaca dokumen secara keseluruhan. Urutan membaca diatur ke dalam blok semantik yang disebut cerita. Cerita adalah unit logis dari dokumen dengan cara yang sama seperti artikel adalah unit dalam majalah. Cerita terdiri dari satu atau beberapa bagian StoryFragments.

Bagian StoryFragments berisi markup struktur konten yang menentukan blok semantik cerita, seperti paragraf dan tabel yang membentuk konten cerita.

Konten bagian DocumentStructure dan StoryFragments dijelaskan dalam Spesifikasi Kertas XML.

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	xpsobjectmodel.h