Metode IOpcSignatureCustomObject::GetXml (msopc.h)

Artikel
02/29/2024

Mendapatkan markup XML dari elemen Objek khusus aplikasi.

Sintaks

HRESULT GetXml(
  [out] UINT8  **xmlMarkup,
  [out] UINT32 *count
);

Parameter

[out] xmlMarkup

Penunjuk ke buffer yang berisi markup XML dari elemen Object dan menyertakan tag Objek pembuka dan penutup.

Di buffer, markup XML didahului oleh tanda urutan byte yang sesuai dengan pengodean markup.

Pengodean yang didukung dan nilai tanda urutan byte .

Pengodean	Deskripsi	Tanda urutan byte
UTF8	UTF-8	EF BB BF
UTF16LE	UTF-16, little endian	FF FE
UTF16BE	UTF-16, big endian	FE FF

Untuk contoh buffer dengan tanda urutan byte, lihat bagian Keterangan.

[out] count

Penunjuk ke ukuran buffer xmlMarkup .

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	Setidaknya salah satu xmlMarkup, dan parameter hitungan adalah NULL.

Keterangan

Metode ini mengalokasikan memori yang digunakan oleh buffer yang dikembalikan dalam xmlMarkup. Jika metode berhasil, panggil fungsi CoTaskMemFree untuk membebaskan memori.

Elemen Objek khusus aplikasi berseri dalam markup tanda tangan dapat ditambahkan, dihapus, atau dimodifikasi dengan mengganti markup tanda tangan.

Untuk mengganti markup tanda tangan, panggil metode IOpcDigitalSignatureManager::ReplaceSignatureXml . Pemanggil harus memastikan bahwa penambahan, penghapusan, atau modifikasi elemen Objek khusus aplikasi tidak merusak tanda tangan.

Untuk menandatangani elemen Objek khusus aplikasi atau turunan dari elemen tersebut, buat referensi ke elemen XML yang akan ditandatangani. Buat referensi dengan memanggil metode IOpcSignatureReferenceSet::Create dengan nilai parameter referenceUri diatur ke "#" diikuti dengan nilai atribut Id dari elemen yang direferensikan. Misalnya, jika atribut Id dari elemen yang dirujuk adalah "Aplikasi", atur referenceUri ke "#Application".

Tabel berikut ini memperlihatkan tanda urutan byte di awal buffer xmlMarkup yang berisi "<Object Id="id1"></Object>":

Indeks Byte Buffer	0	1	2	3	4	5	6	7	...
Nilai UTF8	EF	BB	BF	'<'	'O'	'b'	'j'	'e'	...
Nilai UTF16LE	FF	FE	'<'	00	'O'	00	'b'	00	...

Keamanan Thread

Objek pengemasan tidak aman untuk utas.

Untuk informasi selengkapnya, lihat Memulai PACKAGING API.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	msopc.h