Fungsi panggilan balik CryptXmlDllSignData (cryptxml.h)

  • Artikel

Fungsi CryptXmlDllSignData menandatangani data.

Fungsi CryptXmlDllSignData diekspos melalui fungsi CryptXmlDllGetInterface yang diekspor.

Sintaks

CryptXmlDllSignData Cryptxmldllsigndata;

HRESULT Cryptxmldllsigndata(
  [in]            const CRYPT_XML_ALGORITHM *pSignatureMethod,
  [in]            HCRYPTPROV_OR_NCRYPT_KEY_HANDLE hCryptProvOrNCryptKey,
  [in]            DWORD dwKeySpec,
  [in]            const BYTE *pbInput,
  [in]            ULONG cbInput,
  [out, optional] BYTE *pbOutput,
  [in]            ULONG cbOutput,
  [out]           ULONG *pcbResult
)
{...}

Parameter

[in] pSignatureMethod

Penunjuk ke struktur CRYPT_XML_ALGORITHM yang menentukan algoritma.

[in] hCryptProvOrNCryptKey

Handel penyedia layanan kriptografi (CSP) yang membuat tanda tangan. Handel ini harus berupa handel HCRYPTPROV yang diperoleh dari panggilan ke fungsi CryptAcquireContext atau handel NCRYPT_KEY_HANDLE yang dibuat dengan menggunakan fungsi NCryptOpenKey . Aplikasi baru harus melewati handel NCRYPT_KEY_HANDLE .

[in] dwKeySpec

Kunci privat yang digunakan dari kontainer penyedia. Kunci ini dapat AT_KEYEXCHANGE atau AT_SIGNATURE. Parameter ini diabaikan jika handel NCRYPT_KEY_HANDLE digunakan dalam parameter hCryptProvOrNCryptKey .

[in] pbInput

Penunjuk ke buffer yang berisi nilai hash untuk ditandatangani. Parameter cbInput berisi ukuran buffer ini.

[in] cbInput

Ukuran, dalam byte, dari buffer yang diacu oleh parameter pbInput .

[out, optional] pbOutput

Alamat buffer untuk menerima tanda tangan yang dihasilkan oleh fungsi ini. Parameter cbOutput berisi ukuran buffer ini.

Jika parameter ini NULL, fungsi ini akan menghitung ukuran yang diperlukan untuk data terenkripsi dan mengembalikan ukuran di lokasi yang ditujukkan oleh parameter pcbResult .

[in] cbOutput

Ukuran, dalam byte, dari buffer yang diacu oleh parameter pbOutput .

[out] pcbResult

Penunjuk ke variabel DWORD yang menerima jumlah byte yang disalin ke buffer pbOutput . Jika pbOutputNULL, ini menerima ukuran, dalam byte, diperlukan untuk 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