NCryptSignHash dengan penyedia penyimpanan kunci (KSP) - AWS CloudHSM
ParameterNilai yang Ditampilkan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

NCryptSignHash dengan penyedia penyimpanan kunci (KSP)

NCryptSignHashFungsi ini menciptakan tanda tangan dari nilai hash.

Parameter

hKey[dalam]

Pegangan kunci yang digunakan untuk menandatangani hash.

pPaddingInfo[dalam, opsional]

Sebuah pointer ke struktur yang berisi informasi padding. Jenis struktur tergantung pada dwFlags nilainya. Gunakan parameter ini hanya dengan tombol asimetris; atur ke NULL untuk jenis kunci lainnya.

pbHashValue[dalam]

Sebuah pointer ke buffer yang berisi nilai hash untuk ditandatangani. Tentukan ukuran buffer menggunakancbHashValue.

cbHashValue[dalam]

Ukuran, dalam byte, dari pbHashValue buffer untuk ditandatangani.

pbSignature[keluar]

Alamat buffer untuk menyimpan tanda tangan. Tentukan ukuran buffer menggunakancbSignature.

Untuk menentukan ukuran buffer yang diperlukan, atur parameter ini ke NULL. Fungsi menyimpan ukuran yang diperlukan (dalam byte) di lokasi yang ditunjuk olehpcbResult.

cbSignature[dalam]

Ukuran pbSignature buffer dalam byte. Fungsi mengabaikan parameter ini jika pbSignature NULL.

pcbResult[keluar]

Pointer ke variabel DWORD yang menyimpan jumlah byte yang disalin ke buffer. pbSignature

Jika pbSignature NULL, ini menyimpan ukuran buffer yang diperlukan, dalam byte.

dwFlags[dalam]

Bendera untuk memodifikasi perilaku fungsi. Bendera yang diizinkan bergantung pada jenis kunci Anda. Gunakan salah satu dari nilai-nilai ini:

Nilai Arti

BCRYPT_PAD_ PKCS1

Menggunakan skema PKCS1 padding. Atur pPaddingInfo untuk menunjuk ke BCRYPT_PKCS1_PADDING_INFO struktur.

BCRYPT_PAD_PSS

Menggunakan skema padding Probabilistic Signature Scheme (PSS). Atur pPaddingInfo parameter untuk menunjuk ke BCRYPT_PSS_PADDING_INFO struktur.

NCRYPT_SILENT_FLAG

Bendera ini tidak berpengaruh.

Nilai yang Ditampilkan

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:

Kode pengembalian Deskripsi

ERROR_SUCCESS

Operasi selesai dengan sukses.

NTE_INVALID_PARAMETER

Satu atau lebih parameter tidak valid.

NTE_FAIL

Operasi tidak bisa selesai.

NTE_INVALID_HANDLE

Pegangan masuk hKey tidak valid.

NTE_BAD_FLAGS

dwFlagsParameter berisi nilai yang tidak valid.

NTE_BUFFER_TOO_SMALL

pcbOutputParameternya terlalu kecil untuk mengembalikan nilai.

NTE_BAD_KEY_STATE

Status kunci tidak valid.

NTE_INTERNAL_ERROR

Kesalahan internal terjadi saat menandatangani hash.