Fungsi CryptXmlAddObject (cryptxml.h)

Artikel
02/24/2024

Fungsi CryptXmlAddObject menambahkan elemen Object ke Tanda Tangan dalam Konteks Dokumen yang dibuka untuk pengodean.

Sintaks

HRESULT CryptXmlAddObject(
  [in]            HCRYPTXML                hSignatureOrObject,
                  DWORD                    dwFlags,
  [in, optional]  const CRYPT_XML_PROPERTY *rgProperty,
  [in]            ULONG                    cProperty,
  [in]            const CRYPT_XML_BLOB     *pEncoded,
  [out, optional] const CRYPT_XML_OBJECT   **ppObject
);

Parameter

[in] hSignatureOrObject

Handel Tanda Tangan yang dikembalikan oleh fungsi CryptXmlOpenToEncode atau handel Referensi yang dikembalikan oleh fungsi CryptXmlCreateReference dengan set bendera CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT .

dwFlags

Menentukan bendera yang mengontrol cara objek ditambahkan.

Nilai dwFlags yang saat ini ditentukan diperlihatkan dalam tabel berikut.

Nilai	Makna
CRYPT_XML_ADD_OBJECT_CREATE_REFERENCE	Saat diatur, salinan dalam memori bagian XML dibuat dan disertakan dalam elemen Object .

[in, optional] rgProperty

Penunjuk ke struktur CRYPT_XML_PROPERTY yang menentukan properti tambahan yang digunakan untuk mendekode elemen Object .

[in] cProperty

Jumlah elemen dalam array yang ditujukkan oleh properti rgProperty .

[in] pEncoded

Penunjuk ke struktur CRYPT_XML_BLOB yang berisi elemen Object .

[out, optional] ppObject

Penunjuk ke penunjuk ke struktur CRYPT_XML_OBJECT untuk menerima struktur yang didekodekan. Parameter ini harus NULL ketika parameter hSignatureOrObject berisi handel ke Objek.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan nol.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan.

Keterangan

Ketika parameter hSignatureOrObject menentukan handel ke Referensi yang dikembalikan oleh fungsi CryptXmlCreateReference , parameter pEncoded menentukan konten XML yang disertakan dalam simpul Objek setelah elemen Manifes opsional. Penunjuk yang terkandung dalam parameter pEncoded harus valid hingga tanda tangan selesai. Jika tidak, gunakan bendera CRYPT_XML_FLAG_ADD_OBJECT_CREATE_COPY untuk membuat salinan dalam memori.

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	cryptxml.h
Pustaka	Cryptxml.lib
DLL	Cryptxml.dll