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

# Operasi API yang didukung Penyedia penyimpanan kunci (KSP) untuk AWS CloudHSM Klien SDK 5
<a name="ksp-library-apis"></a>

Parameter dalam KSP ditentukan oleh Microsoft KSP. Lihat [dokumentasi Microsoft](https://learn.microsoft.com/en-us/windows/win32/api/ncrypt/) untuk informasi selengkapnya.

Penyedia Penyimpanan Kunci (KSP) mendukung operasi API KSP berikut untuk AWS CloudHSM Client SDK 5.
+ [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md)
+ [NCryptOpenKey](ksp-library-apis-open-key.md)
+ [NCryptCreatePersistedKey](ksp-library-apis-create-persisted-key.md)
+ [NCryptGetProperty](ksp-library-apis-get-property.md)
+ [NCryptSetProperty](ksp-library-apis-set-property.md)
+ [NCryptFinalizeKey](ksp-library-apis-finalize-key.md)
+ [NCryptDeleteKey](ksp-library-apis-delete-key.md)
+ [NCryptFreeObject](ksp-library-apis-free-object.md)
+ [NCryptFreeBuffer](ksp-library-apis-free-buffer.md)
+ [NCryptIsAlgSupported](ksp-library-apis-is-alg-supported.md)
+ [NCryptEnumAlgorithms](ksp-library-apis-enum-algorithms.md)
+ [NCryptEnumKeys](ksp-library-apis-enum-keys.md)
+ [NCryptExportKey](ksp-library-apis-export-key.md)
+ [NCryptSignHash](ksp-library-apis-sign-hash.md)
+ [NCryptVerifySignature](ksp-library-apis-verify-signature.md)

# NCryptOpenStorageProvider berfungsi dengan Penyedia Penyimpanan Kunci (KSP)
<a name="ksp-library-apis-open-provider"></a>

`NCryptOpenStorageProvider`Fungsi memuat dan menginisialisasi Penyedia Penyimpanan Kunci (KSP).

## Parameter
<a name="ksp-library-apis-open-provider-parameters"></a>

 `phProvider`[keluar]   
Pointer ke `NCRYPT_PROV_HANDLE` variabel yang menyimpan pegangan penyedia.

 `pszProviderName`[dalam]   
Pointer ke string Unicode yang dihentikan nol yang mengidentifikasi penyedia penyimpanan kunci. AWS CloudHSM Key Storage Provider (KSP) mendukung nilai-nilai berikut:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-open-provider.html)
Nilai adalah string karakter lebar literal, seperti yang ditunjukkan oleh L sebelum literal.

`dwFlags`[dalam]  
Bendera yang mengubah perilaku fungsi. Tidak ada bendera yang ditentukan untuk fungsi ini.

## Nilai yang Ditampilkan
<a name="ksp-library-apis-open-provider-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 

# NCryptOpenKey dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-open-key"></a>

`NCryptOpenKey`Fungsi ini membuka kunci yang ada di Penyedia Penyimpanan Kunci (KSP).

## Parameter
<a name="ksp-library-apis-open-key-parameters"></a>

 `hProvider`[dalam]   
Pegangan KSP yang berisi kunci. Gunakan [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md)untuk mendapatkan pegangan.

 `phKey`[Keluar]   
Sebuah pointer ke `NCRYPT_KEY_HANDLE` variabel yang menyimpan pegangan kunci.

`pszKeyName`[dalam]  
Sebuah pointer ke string Unicode null-terminated yang berisi nama kunci.

`dwLegacyKeySpec`[di, tidak terpakai]  
AWS CloudHSM Penyedia Penyimpanan Kunci (KSP) tidak menggunakan parameter ini.

`dwFlags`[dalam]  
Bendera yang memodifikasi perilaku fungsi. Tidak ada bendera yang ditentukan untuk fungsi ini.

## Nilai yang Ditampilkan
<a name="ksp-library-apis-open-key-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode kembalikan | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 
|  NTE\$1INVALID\$1HANDLE  |  Pegangan masuk `hProvider` tidak valid.  | 
|  NTE\$1BAD\$1KEYSET  |  Nama kunci yang diberikan tidak mengembalikan hasil yang unik.  | 

# NCryptCreatePersistedKey dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-create-persisted-key"></a>

`NCryptCreatePersistedKey`Fungsi ini membuat kunci baru dan menyimpannya di Penyedia Penyimpanan Kunci (KSP). Anda dapat menggunakan [`NCryptSetProperty`](ksp-library-apis-set-property.md)fungsi untuk mengatur propertinya setelah pembuatan. Anda harus menelepon [`NCryptFinalizeKey`](ksp-library-apis-finalize-key.md)sebelum Anda dapat menggunakan kunci.

## Parameter
<a name="ksp-library-apis-create-persisted-key-parameters"></a>

 `hProvider`[dalam]   
Pegangan penyedia penyimpanan kunci tempat Anda akan membuat kunci. Gunakan [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md)untuk mendapatkan pegangan ini.

 `phKey`[Keluar]   
Alamat `NCRYPT_KEY_HANDLE` variabel yang menyimpan pegangan kunci. 

 `pszAlgId`[dalam]   
Pointer ke string Unicode yang dihentikan nol yang menentukan pengidentifikasi algoritma kriptografi untuk membuat kunci.  
AWS CloudHSM Penyedia Penyimpanan Kunci (KSP) mendukung algoritma berikut:     
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

`pszKeyName`[dalam, opsional]  
Pointer ke string Unicode yang dihentikan nol yang berisi nama kunci. Jika parameter ini adalah NULL, fungsi ini akan membuat kunci fana yang tidak bertahan.

`dwLegacyKeySpec`[di, tidak terpakai]  
AWS CloudHSM Penyedia Penyimpanan Kunci (KSP) tidak menggunakan parameter ini.

`dwFlags`[dalam]  
Bendera untuk memodifikasi perilaku fungsi. Gunakan nol atau lebih dari nilai-nilai berikut:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

## Nilai yang Ditampilkan
<a name="ksp-library-apis-create-persisted-key-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Fungsi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags`Parameter berisi nilai yang tidak valid.  | 
|  NTE\$1NOT\$1SUPPORTED  |  `pszAlgId`Parameter berisi nilai yang tidak didukung.  | 
|  NTE\$1EXISTS  |  Kunci dengan nama yang ditentukan sudah ada dan operasi tidak digunakan` NCRYPT_OVERWRITE_KEY_FLAG`.  | 

# NCryptGetProperty dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-get-property"></a>

`NCryptGetProperty`Fungsi mengambil nilai properti untuk objek penyimpanan kunci.

## Parameter
<a name="ksp-library-apis-create-get-property-parameters"></a>

 `hObject`[dalam]   
 Pegangan objek yang propertinya ingin Anda ambil. Anda dapat menggunakan:  
+ Pegangan penyedia (`NCRYPT_PROV_HANDLE`)
+ Sebuah pegangan kunci (`NCRYPT_KEY_HANDLE`)

 `pszProperty `[dalam]   
Sebuah pointer ke string Unicode null-terminated yang berisi nama properti untuk diambil.   
Saat menggunakan`NCRYPT_PROV_HANDLE`, Penyedia Penyimpanan AWS CloudHSM Kunci (KSP) mendukung pengidentifikasi KSP berikut:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
Saat menggunakan`NCRYPT_KEY_HANDLE`, Penyedia Penyimpanan AWS CloudHSM Kunci (KSP) mendukung pengidentifikasi KSP berikut:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
Nilai adalah string karakter lebar literal, seperti yang ditunjukkan oleh L sebelum literal.

 `pbOutput`[Keluar]   
Alamat buffer untuk menyimpan nilai properti. Tentukan ukuran buffer menggunakan`cbOutput`.  
Untuk menentukan ukuran buffer yang diperlukan, atur parameter ini ke NULL. Fungsi menyimpan ukuran yang diperlukan (dalam byte) di lokasi yang ditunjuk oleh`pcbResult`.

 `cbOutput`[dalam]   
 Ukuran `pbOutput` buffer dalam byte.

`pcbResult`[Keluar]  
Pointer ke variabel DWORD yang menyimpan jumlah byte yang disalin ke buffer. `pbOutput`  
Jika NULL, ini menyimpan ukuran yang diperlukan (dalam byte). `pbOutput`

`dwFlags`[dalam]  
Bendera untuk memodifikasi perilaku fungsi. Anda dapat menggunakan nol atau:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
Ketika PSZProperty`NCRYPT_SECURITY_DESCR_PROPERTY`, gunakan satu atau kombinasi dari:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)

## Nilai yang Ditampilkan
<a name="ksp-library-apis-get-property-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags`Parameter berisi nilai yang tidak valid.  | 
|  NTE\$1NOT\$1SUPPORTED  |  `pszAlgId`Parameter berisi nilai yang tidak didukung.  | 
|  NTE\$1INVALID\$1HANDLE  |  Pegangan masuk `hObject` tidak valid.  | 
|  NTE\$1BUFFER\$1TOO\$1SMALL  |  `cbOutput`Parameternya terlalu kecil untuk mengembalikan nilai.  | 

# NCryptSetProperty dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-set-property"></a>

`NCryptSetProperty`Fungsi menetapkan nilai properti untuk objek penyimpanan kunci.

## Parameter
<a name="ksp-library-apis-create-set-property-parameters"></a>

 `hObject`[dalam]   
 Pegangan objek yang propertinya ingin Anda atur. Anda dapat menggunakan:  
+ Pegangan penyedia (`NCRYPT_PROV_HANDLE`)
+ Sebuah pegangan kunci (`NCRYPT_KEY_HANDLE`)

 `pszProperty `[dalam]   
Sebuah pointer ke string Unicode null-terminated yang berisi nama properti untuk diambil.   
Saat menggunakan`NCRYPT_PROV_HANDLE`, Penyedia Penyimpanan AWS CloudHSM Kunci (KSP) mendukung pengidentifikasi KSP berikut:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-set-property.html)
Saat menggunakan`NCRYPT_KEY_HANDLE`, Penyedia Penyimpanan AWS CloudHSM Kunci (KSP) mendukung pengidentifikasi KSP berikut:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-set-property.html)
Nilai adalah string karakter lebar literal, seperti yang ditunjukkan oleh L sebelum literal.

 `pbInput`[dalam]   
 Alamat buffer yang berisi nilai properti baru. `cbInput`berisi ukuran buffer. 

 `cbInput`[dalam]   
 Ukuran `pbInput` buffer dalam byte. 

`dwFlags`[dalam]  
Bendera yang memodifikasi perilaku fungsi. Tidak ada bendera yang ditentukan untuk fungsi ini.

## Nilai yang Ditampilkan
<a name="ksp-library-apis-set-property-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags`Parameter berisi nilai yang tidak valid.  | 
|  NTE\$1NOT\$1SUPPORTED  |  `pszProperty`Parameter berisi nilai yang tidak didukung.  | 
|  NTE\$1INVALID\$1HANDLE  |  Pegangan masuk `hObject` tidak valid.  | 
|  NTE\$1BAD\$1DATA  |  Data yang ditunjukkan oleh `pbInput` dan `cbInput` tidak valid.  | 

# NCryptFinalizeKey dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-finalize-key"></a>

`NCryptFinalizeKey`Fungsi ini melengkapi kunci KSP. Anda harus memanggil fungsi ini sebelum Anda dapat menggunakan kunci.

## Parameter
<a name="ksp-library-apis-finalize-key-parameters"></a>

 `hKey`[dalam]   
 Pegangan kunci untuk menyelesaikan. Dapatkan pegangan ini dengan memanggil [NCryptCreatePersistedKey](ksp-library-apis-create-persisted-key.md)fungsi.

`dwFlags`[dalam]  
Bendera untuk memodifikasi perilaku fungsi. Anda dapat menggunakan nol atau nilai-nilai ini:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-finalize-key.html)

## Nilai yang Ditampilkan
<a name="ksp-library-apis-finalize-key-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 
|  NTE\$1INVALID\$1HANDLE  |  Pegangan masuk `hKey` tidak valid.  | 
|  NTE\$1NOT\$1SUPPORTED  |  `dwFlags`Parameter berisi nilai yang tidak didukung.  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags`Parameter berisi nilai yang tidak valid.  | 

# NCryptDeleteKey dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-delete-key"></a>

`NCryptDeleteKey`Fungsi menghapus kunci KSP dari Penyedia Penyimpanan Kunci (KSP).

## Parameter
<a name="ksp-library-apis-delete-key-parameters"></a>

 `hKey`[dalam]   
 Pegangan kunci untuk dihapus. 

`dwFlags`[dalam]  
Bendera untuk memodifikasi perilaku fungsi. Anda dapat menggunakan nol atau lebih dari nilai-nilai berikut:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-delete-key.html)

## Nilai yang Ditampilkan
<a name="ksp-library-apis-delete-key-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Fungsinya berhasil.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags`Parameter berisi nilai yang tidak valid.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 
|  NTE\$1INVALID\$1HANDLE  |  Pegangan masuk `hKey` tidak valid.  | 
|  NTE\$1INTERNAL\$1ERROR  |  Kesalahan internal terjadi saat menghapus kunci.  | 

# NCryptFreeObject dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-free-object"></a>

`NCryptFreeObject`Fungsi melepaskan provider atau key handle dari Key Storage Provider (KSP).

## Parameter
<a name="ksp-library-apis-free-object-parameters"></a>

 `hObject`[dalam]   
 Pegangan objek untuk dilepaskan. Anda dapat menggunakan:  
+ Pegangan penyedia (`NCRYPT_PROV_HANDLE`)
+ Sebuah pegangan kunci (`NCRYPT_KEY_HANDLE`)

## Nilai yang Ditampilkan
<a name="ksp-library-apis-free-object-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1HANDLE  |  Pegangan masuk `hObject` tidak valid.  | 

# NCryptFreeBuffer dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-free-buffer"></a>

`NCryptFreeBuffer`Fungsi ini melepaskan blok memori yang dialokasikan oleh Penyedia Penyimpanan Kunci (KSP).

## Parameter
<a name="ksp-library-apis-free-buffer-parameters"></a>

 `pvInput`[dalam]   
 Alamat memori yang akan dilepaskan. 

## Nilai yang Ditampilkan
<a name="ksp-library-apis-free-buffer-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 

# NCryptIsAlgSupported dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-is-alg-supported"></a>

NCryptIsAlgSupported fungsi menentukan apakah Key Storage Provider (KSP) mendukung algoritma kriptografi tertentu.

## Parameter
<a name="ksp-library-apis-is-alg-supported-parameters"></a>

 `hProvider`[dalam]   
 Pegangan penyedia penyimpanan kunci. Gunakan [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md)untuk mendapatkan pegangan. 

 `pszAlgId`[dalam]   
 Pointer ke string Unicode yang dihentikan nol yang berisi pengidentifikasi algoritma kriptografi untuk membuat kunci. AWS CloudHSM Key Storage Provider (KSP) mendukung algoritma berikut:     
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-is-alg-supported.html)

`dwFlags`[dalam]  
Bendera yang memodifikasi perilaku fungsi. Ini bisa nol atau nilai berikut:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-is-alg-supported.html)

## Nilai yang Ditampilkan
<a name="ksp-library-apis-is-alg-supported-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode kembalikan | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags`Parameter berisi nilai yang tidak valid.  | 
|  NTE\$1NOT\$1SUPPORTED  |  `pszAlgId`Parameter berisi nilai yang tidak didukung.  | 
|  NTE\$1INVALID\$1HANDLE  |  Pegangan masuk `hProvider` tidak valid.  | 

# NCryptEnumAlgorithms dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-enum-algorithms"></a>

`NCryptEnumAlgorithms`Fungsi ini mengambil nama-nama algoritma yang didukung oleh Penyedia Penyimpanan Kunci (KSP).

## Parameter
<a name="ksp-library-apis-enum-algorithms-parameters"></a>

 `hProvider`[dalam]   
 Pegangan penyedia penyimpanan kunci untuk menghitung algoritma. Gunakan [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md)fungsi untuk mendapatkan pegangan ini. 

 `dwAlgOperations`[dalam]   
Satu set nilai yang menentukan kelas algoritma mana yang akan dihitung. Anda dapat menggunakan nol untuk menghitung semua algoritma, atau menggabungkan satu atau lebih dari nilai-nilai ini:     
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-enum-algorithms.html)

`pdwAlgCount`[Keluar]  
Alamat DWORD yang menyimpan jumlah elemen dalam `ppAlgList` array.

`ppAlgList`[Keluar]  
Alamat pointer `NCryptAlgorithmName` struktur yang menyimpan array nama algoritma terdaftar. `pdwAlgCount`Parameter menunjukkan jumlah elemen dalam array ini.

`dwFlags`[dalam]  
Bendera untuk memodifikasi perilaku fungsi. Gunakan nol atau nilai berikut:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-enum-algorithms.html)

## Nilai yang Ditampilkan
<a name="ksp-library-apis-open-key-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags`Parameter berisi nilai yang tidak valid.  | 
|  NTE\$1NOT\$1SUPPORTED  |  `dwAlgOperations`Parameter berisi nilai yang tidak didukung.  | 

# NCryptEnumKeys dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-enum-keys"></a>

NCryptEnumKeys fungsi daftar kunci yang disimpan di Penyedia Penyimpanan Kunci (KSP).

## Parameter
<a name="ksp-library-apis-enum-keys-parameters"></a>

 `hProvider`[dalam]   
Pegangan penyedia penyimpanan utama. Gunakan [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md)untuk mendapatkan pegangan ini. 

 `pszScope`[di, tidak terpakai]   
 Setel parameter ini ke NULL.

 `ppKeyName`[keluar]   
Alamat pointer ke `NCryptKeyName` struktur yang menyimpan nama kunci. Untuk membebaskan memori ini setelah digunakan, hubungi`NCryptFreeBuffer`. 

`ppEnumState`[masuk, keluar]  
Alamat pointer VOID yang melacak kemajuan enumerasi. Penyedia penyimpanan kunci menggunakan informasi ini secara internal untuk mengelola urutan enumerasi. Untuk memulai enumerasi baru dari awal, atur pointer ini ke NULL.  
Untuk membebaskan memori ini setelah menyelesaikan enumerasi, berikan pointer ini ke file. `NCryptFreeBuffer`

`dwFlags`[dalam]  
Bendera untuk memodifikasi perilaku fungsi. Fungsi ini tidak memiliki bendera.

## Nilai yang Ditampilkan
<a name="ksp-library-apis-enum-keys-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 
|  NTE\$1INVALID\$1HANDLE  |  Pegangan masuk `hProvider` tidak valid.  | 
|  NTE\$1NO\$1MORE\$1ITEMS  |  Enumerasi telah mencantumkan semua kunci yang tersedia.  | 

# NCryptExportKey dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-export-key"></a>

`NCryptExportKey`Fungsi mengekspor kunci KSP ke memori. BLOB Fungsi ini hanya mendukung ekspor kunci publik.

## Parameter
<a name="ksp-library-apis-export-key-parameters"></a>

 `hKey`[dalam]  
Pegangan kunci untuk mengekspor.

 `hExportKey`[di, tidak terpakai]  
 AWS CloudHSM Penyedia Penyimpanan Kunci (KSP) tidak menggunakan parameter ini. 

`pszBlobType`[dalam]  
String Unicode yang dihentikan nol yang menentukan jenis yang akan diekspor. BLOB AWS CloudHSM Penyedia Penyimpanan Kunci (KSP) mendukung nilai-nilai berikut:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-export-key.html)

`pParameterList`[di, tidak terpakai]  
AWS CloudHSM Penyedia Penyimpanan Kunci (KSP) tidak menggunakan parameter ini.

`pbOutput`[keluar, opsional]  
Alamat buffer untuk menyimpan BLOB kunci. Tentukan ukuran buffer menggunakan`cbOutput`. Jika disetel ke NULL, fungsi menyimpan ukuran yang diperlukan (dalam byte) di DWORD yang ditunjuk oleh. `pcbResult`

`cbOutput`[dalam]  
Ukuran `pbOutput` buffer dalam byte.

`pcbResult`[keluar]  
Alamat variabel DWORD yang menyimpan jumlah byte yang disalin ke buffer. `pbOutput` Jika `pbOutput` NULL, fungsi menyimpan ukuran buffer yang diperlukan dalam byte.

`dwFlags`[dalam]  
Bendera yang memodifikasi cara kerja fungsi. Anda dapat menggunakan nol atau berikut ini:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-export-key.html)

## Nilai yang Ditampilkan
<a name="ksp-library-apis-export-key-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 
|  NTE\$1INVALID\$1HANDLE  |  Pegangan masuk `hProvider` tidak valid.  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags`Parameter berisi nilai yang tidak valid.  | 
|  NTE\$1BAD\$1KEY\$1STATE  |  Status kunci tidak valid.  | 
|  NTE\$1NOT\$1SUPPORTED  |  `dwFlags`Parameter `pszBlobType` atau berisi nilai yang tidak didukung.  | 
|  STATUS\$1INTERNAL\$1ERROR  |  Kesalahan internal terjadi selama operasi.  | 

# NCryptSignHash dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-sign-hash"></a>

`NCryptSignHash`Fungsi ini menciptakan tanda tangan dari nilai hash.

## Parameter
<a name="ksp-library-apis-sign-hash-parameters"></a>

 `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 menggunakan`cbHashValue`.

`cbHashValue`[dalam]  
Ukuran, dalam byte, dari `pbHashValue` buffer untuk ditandatangani.

`pbSignature`[keluar]  
Alamat buffer untuk menyimpan tanda tangan. Tentukan ukuran buffer menggunakan`cbSignature`.  
Untuk menentukan ukuran buffer yang diperlukan, atur parameter ini ke NULL. Fungsi menyimpan ukuran yang diperlukan (dalam byte) di lokasi yang ditunjuk oleh`pcbResult`.

`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:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-sign-hash.html)

## Nilai yang Ditampilkan
<a name="ksp-library-apis-sign-hash-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode pengembalian | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 
|  NTE\$1INVALID\$1HANDLE  |  Pegangan masuk `hKey` tidak valid.  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags`Parameter berisi nilai yang tidak valid.  | 
|  NTE\$1BUFFER\$1TOO\$1SMALL  |  `pcbOutput`Parameternya terlalu kecil untuk mengembalikan nilai.  | 
|  NTE\$1BAD\$1KEY\$1STATE  |  Status kunci tidak valid.  | 
|  NTE\$1INTERNAL\$1ERROR  |  Kesalahan internal terjadi saat menandatangani hash.  | 

# NCryptVerifySignature dengan penyedia penyimpanan kunci (KSP)
<a name="ksp-library-apis-verify-signature"></a>

`NCryptVerifySignature`Fungsi ini mengonfirmasi apakah tanda tangan cocok dengan hash tertentu.

## Parameter
<a name="ksp-library-apis-verify-signature-parameters"></a>

 `hKey`[dalam]   
 Pegangan kunci yang digunakan untuk mendekripsi tanda tangan. Anda harus menggunakan bagian kunci publik dari key pair yang digunakan untuk menandatangani data dengan [`NCryptSignHash`](ksp-library-apis-sign-hash.md). 

`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 menggunakan`cbHashValue`.

`cbHashValue`[dalam]  
Ukuran `pbHashValue` buffer dalam byte.

`pbSignature`[Keluar]  
Alamat buffer yang berisi hash data yang ditandatangani. Gunakan [`NCryptSignHash`](ksp-library-apis-sign-hash.md)untuk membuat tanda tangan ini. Tentukan ukuran buffer menggunakan`cbSignature`.

`cbSignature`[dalam]  
Ukuran `pbSignature` buffer dalam byte. Gunakan [`NCryptSignHash`](ksp-library-apis-sign-hash.md)untuk membuat tanda tangan.

`dwFlags`[dalam]  
Bendera untuk memodifikasi perilaku fungsi. Bendera yang diizinkan bergantung pada jenis kunci Anda. Gunakan salah satu dari nilai-nilai ini:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudhsm/latest/userguide/ksp-library-apis-verify-signature.html)

## Nilai yang Ditampilkan
<a name="ksp-library-apis-verify-signature-return-value"></a>

Fungsi mengembalikan kode status untuk menunjukkan keberhasilan atau kegagalan.

Kode pengembalian umum meliputi:


****  

| Kode kembalikan | Deskripsi | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Operasi selesai dengan sukses.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Satu atau lebih parameter tidak valid.  | 
|  NTE\$1FAIL  |  Operasi tidak bisa selesai.  | 
|  NTE\$1INVALID\$1HANDLE  |  Pegangan masuk `hKey` tidak valid.  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags`Parameter berisi nilai yang tidak valid.  | 
|  NTE\$1BAD\$1SIGNATURE  |  Tanda tangan tidak diverifikasi.  | 
|  NTE\$1BAD\$1KEY\$1STATE  |  Status kunci tidak valid.  | 
|  NTE\$1INTERNAL\$1ERROR  |  Kesalahan internal terjadi saat memverifikasi tanda tangan.  |