Fungsi CryptXmlOpenToDecode (cryptxml.h)

Fungsi CryptXmlOpenToDecode membuka tanda tangan digital XML untuk mendekode dan mengembalikan handel konteks dokumen yang merangkum struktur CRYPT_XML_SIGNATURE . Konteks dokumen dapat menyertakan satu atau beberapa elemen Tanda Tangan .

Sintaks

HRESULT CryptXmlOpenToDecode(
  [in, optional] const CRYPT_XML_TRANSFORM_CHAIN_CONFIG *pConfig,
                 DWORD                                  dwFlags,
  [in]           const CRYPT_XML_PROPERTY               *rgProperty,
                 ULONG                                  cProperty,
  [in]           const CRYPT_XML_BLOB                   *pEncoded,
                 HCRYPTXML                              *phCryptXml
);

Parameter

[in, optional] pConfig

Handel mesin rantai transformasi. Jika parameter ini NULL, maka mesin default akan digunakan untuk menerapkan transformasi.

dwFlags

Nilai DWORD yang mengontrol ekstensi CryptXML mana yang dimuat dan apakah XML diserialisasikan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CRYPT_XML_FLAG_NO_SERIALIZE 0x80000000	Menghambat serialisasi. Penting Jangan atur bendera ini ketika beberapa utas mengakses objek CryptXml. Serialisasi memastikan pengecualian timbal balik ketika dua utas atau lebih mencoba menerima objek atau memori CryptXml secara bersamaan.
CRYPT_XML_FLAG_DISABLE_EXTENSIONS 0x10000000	Hanya implementasi default untuk tanda tangan dan hash yang digunakan. Ketika bendera ini diatur, tidak ada ekstensi terdaftar lain yang dimuat.

[in] rgProperty

Penunjuk ke array struktur CRYPT_XML_PROPERTY yang berisi properti tambahan.

cProperty

Jumlah item dalam array yang ditujukkan oleh parameter rgProperty .

[in] pEncoded

Penunjuk ke struktur CRYPT_XML_BLOB yang berisi tanda tangan untuk didekodekan.

phCryptXml

Handel objek Konteks Dokumen. Setelah Anda selesai menggunakan handel, lepaskan dengan meneruskannya ke fungsi CryptXmlClose .

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