NCryptSignHashdengan 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.

NCryptSignHashdengan 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; diatur 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 keNULL. 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 adaNULL.

pcbResult[Keluar]

Sebuah pointer ke DWORD variabel yang menyimpan jumlah byte disalin ke buffer. pbSignature

Jika yaNULL, pbSignature 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 Skema Tanda Tangan Probabilistik (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.