IOpcSignatureCustomObjectSet::Buat metode (msopc.h)

Artikel
03/05/2024

Membuat penunjuk antarmuka IOpcSignatureCustomObject untuk mewakili elemen Objek khusus aplikasi dalam tanda tangan, dan menambahkan antarmuka baru ke set.

Sintaks

HRESULT Create(
  [in]          const UINT8               *xmlMarkup,
  [in]          UINT32                    count,
  [out, retval] IOpcSignatureCustomObject **customObject
);

Parameter

[in] xmlMarkup

Buffer yang berisi markup XML untuk elemen Object yang akan diwakili.

Markup XML ini harus menyertakan Objek pembuka dan menutup tag /Object .

Pengodean markup yang terkandung dalam xmlMarkup akan disimpulkan. Penyertaan tanda urutan byte di awal buffer yang diteruskan di xmlMarkup bersifat opsional.

Pengodean berikut dan nilai tanda urutan byte didukung:

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

[in] count

Ukuran buffer xmlMarkup .

[out, retval] customObject

Penunjuk antarmuka IOpcSignatureCustomObject baru yang mewakili elemen Objek khusus aplikasi.

Parameter ini dapat berupa NULL jika penunjuk ke antarmuka baru tidak diperlukan.

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_INVALIDARG	Parameter hitungan adalah 0. Parameter xmlMarkup harus diteruskan markup XML yang valid.
E_POINTER	Parameter xmlMarkup adalah NULL.

Keterangan

Penunjuk antarmuka IOpcSignatureCustomObject menyediakan akses ke markup XML dari elemen Objek yang diwakilinya. Untuk mengakses markup XML elemen Object , panggil metode IOpcSignatureCustomObject::GetXml .

Ketika penunjuk antarmuka IOpcSignatureCustomObject dibuat dan ditambahkan ke set, Objek yang diwakilinya disimpan saat paket disimpan.

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