Fungsi CryptXmlDigestReference (cryptxml.h)

Artikel
08/22/2023

Fungsi CryptXmlDigestReference digunakan oleh aplikasi untuk mencerna referensi yang diselesaikan. Fungsi ini menerapkan transformasi sebelum memperbarui hash.

Sintaks

HRESULT CryptXmlDigestReference(
  [in] HCRYPTXML               hReference,
       DWORD                   dwFlags,
  [in] CRYPT_XML_DATA_PROVIDER *pDataProviderIn
);

Parameter

[in] hReference

Handel elemen Referensi .

dwFlags

Menentukan nilai yang mengontrol bagaimana proses menerapkan transformasi.

DwFlags yang saat ini ditentukan ditampilkan dalam tabel berikut.

Nilai	Makna
CRYPT_XML_REFERENCE_DATA_TRANSFORMED 0x00000001	Menentukan bahwa mesin pemrosesan akan membuat hash tanpa menerapkan mesin rantai transformasi.

[in] pDataProviderIn

Penunjuk ke struktur CRYPT_XML_DATA_PROVIDER yang menentukan penyedia data. Fungsi CryptXmlDigestReference selalu memanggil fungsi fpnClose pada penyedia data.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan nol.

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

Keterangan

Ketika bendera CRYPT_XML_REFERENCE_DATA_TRANSFORMED diatur, mesin pemrosesan menambahkan data yang diterima langsung ke hash tanpa menerapkan mesin rantai transformasi.

Catatan Fungsi CryptXmlDigestReference selalu memanggil fungsi yang ditunjukkan oleh anggota fpnClose dari struktur CRYPT_XML_DATA_PROVIDER yang ditunjukkan oleh parameter pDataProviderIn .

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