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

# 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\_SUCCESS | Operasi selesai dengan sukses. | 
| NTE\_INVALID\_PARAMETER | Satu atau lebih parameter tidak valid. | 
| NTE\_FAIL | Operasi tidak bisa selesai. | 
| NTE\_BAD\_FLAGS | `dwFlags`Parameter berisi nilai yang tidak valid. | 
| NTE\_NOT\_SUPPORTED | `pszAlgId`Parameter berisi nilai yang tidak didukung. | 
| NTE\_INVALID\_HANDLE | Pegangan masuk `hObject` tidak valid. | 
| NTE\_BUFFER\_TOO\_SMALL | `cbOutput`Parameternya terlalu kecil untuk mengembalikan nilai. |