IXpsOMDictionary::Append method (xpsobjectmodel.h)

Artikel
03/15/2023

Menambahkan antarmuka IXpsOMShareable bersama dengan kuncinya ke akhir kamus.

Sintaks

HRESULT Append(
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

Parameter

[in] key

Kunci yang akan digunakan untuk entri ini.

String yang direferensikan oleh kunci harus unik dalam kamus.

[in] entry

Penunjuk ke antarmuka IXpsOMShareable yang akan ditambahkan ke kamus.

Kamus tidak boleh berisi penunjuk antarmuka duplikat. Parameter ini harus berisi penunjuk antarmuka yang belum ada dalam kamus.

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.
XPS_E_NO_CUSTOM_OBJECTS	entri tidak menunjuk ke implementasi antarmuka yang dikenali. Implementasi kustom antarmuka XPS Document API tidak didukung.

Keterangan

Pointer antarmuka yang disimpan dalam kamus biasanya akan menunjuk ke antarmuka, seperti IXpsOMBrush dan IXpsOMVisual, yang berasal dari antarmuka IXpsOMShareable . Untuk menentukan jenis antarmuka, panggil metode IXpsOMShareable::GetType .

Gambar berikut menggambarkan bagaimana kamus diubah oleh metode Tambahkan .

Gambar yang memperlihatkan bagaimana Tambahkan menambahkan entri ke kamus

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