Fungsi CryptXmlCreateReference (cryptxml.h)

  • Artikel

Fungsi CryptXmlCreateReference membuat referensi ke tanda tangan XML.

Sintaks

HRESULT CryptXmlCreateReference(
  [in]           HCRYPTXML                 hCryptXml,
                 DWORD                     dwFlags,
  [in, optional] LPCWSTR                   wszId,
  [in, optional] LPCWSTR                   wszURI,
  [in, optional] LPCWSTR                   wszType,
  [in]           const CRYPT_XML_ALGORITHM *pDigestMethod,
                 ULONG                     cTransform,
  [in]           const CRYPT_XML_ALGORITHM *rgTransform,
  [out]          HCRYPTXML                 *phReference
);

Parameter

[in] hCryptXml

Handel tanda tangan XML.

dwFlags

Menentukan bendera yang memengaruhi cara referensi dibuat.

Nilai dwFlags yang saat ini ditentukan ditampilkan dalam tabel berikut.

Nilai Makna
CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT
0x00000001
 Atur bendera ini untuk membuat simpul Objek dan menambahkannya ke elemen Tanda Tangan . Referensi ke simpul Objek dibuat di elemen SignedInfo .

Handel yang dikembalikan adalah simpul Objek yang dienkapsulasi dan dapat digunakan dalam panggilan berikutnya ke fungsi CryptXmlCreateReference untuk membuat referensi dalam simpul Manifes .

[in, optional] wszId

Penunjuk ke string Unicode yang dihentikan null yang berisi nilai atribut ID dari elemen Referensi tanda tangan. Jika parameter ini NULL, maka atribut ID tidak dibuat. Jika parameter ini adalah string kosong, maka atribut ID dengan nilai kosong akan dibuat.

[in, optional] wszURI

Penunjuk ke string Unicode yang dihentikan null yang berisi nilai atribut URI dari elemen Referensi tanda tangan. Jika parameter ini adalah string kosong, maka atribut URI dengan nilai kosong akan dibuat.

[in, optional] wszType

Penunjuk ke string Unicode yang dihentikan null yang berisi nilai atribut Type dari elemen Referensi tanda tangan. Mesin pemrosesan tidak memeriksa atau menggunakan atribut ini.

[in] pDigestMethod

Penunjuk ke struktur CRYPT_XML_ALGORITHM yang berisi metode hash.

cTransform

Jumlah elemen dalam array yang ditujukkan oleh parameter rgTransform .

[in] rgTransform

Penunjuk ke array terurut dari struktur CRYPT_XML_ALGORITHM yang berisi algoritma transformasi untuk diterapkan ke data referensi sebelum perhitungan hash.

[out] phReference

Penunjuk ke handel referensi.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan nol.

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

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