Fungsi CryptXmlOpenToEncode (cryptxml.h)

  • Artikel

Jika fungsi CryptXmlOpenToEncode membuka tanda tangan digital XML untuk mengodekan dan mengembalikan handel elemen Tanda Tangan yang dibuka. Handel merangkum konteks dokumen dengan struktur CRYPT_XML_SIGNATURE tunggal dan tetap terbuka sampai fungsi CryptXmlClose dipanggil.

Sintaks

HRESULT CryptXmlOpenToEncode(
  [in, optional] const CRYPT_XML_TRANSFORM_CHAIN_CONFIG *pConfig,
                 DWORD                                  dwFlags,
  [in, optional] LPCWSTR                                wszId,
  [in]           const CRYPT_XML_PROPERTY               *rgProperty,
  [in]           ULONG                                  cProperty,
  [in, optional] const CRYPT_XML_BLOB                   *pEncoded,
  [optional]     HCRYPTXML                              *phSignature
);

Parameter

[in, optional] pConfig

Handel mesin rantai transformasi. Jika parameter ini NULL, maka mesin default 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.
Catatan 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, optional] wszId

Penunjuk ke string Unicode yang dihentikan null yang berisi atribut Id elemen Signature . Jika parameter ini NULL, maka GUID baru dihasilkan. Jika parameter ini adalah string kosong, maka tidak ada atribut Id yang dihasilkan.

[in] rgProperty

Penunjuk ke array struktur CRYPT_XML_PROPERTY yang menentukan properti tambahan.

[in] cProperty

Jumlah elemen dalam array yang ditujukkan oleh parameter rgProperty .

[in, optional] pEncoded

Penunjuk ke struktur CRYPT_XML_BLOB yang berisi tanda tangan untuk dikodekan.

[optional] phSignature

Handel ke elemen Tanda Tangan .

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