Metode IX509CertificateRequestPkcs10::get_CspStatuses (certenroll.h)

  • Artikel

Properti CspStatuses mengambil kumpulan objek ICspStatus yang cocok dengan penggunaan kunci privat yang dimaksudkan yang terkait dengan permintaan sertifikat.

Properti ini bersifat hanya baca.

Sintaks

HRESULT get_CspStatuses(
  ICspStatuses **ppValue
);

Parameter

ppValue

Menampilkan nilai

Tidak ada

Keterangan

Properti ini mengambil kumpulan objek ICspStatus . Setiap objek mewakili satu pasangan penyedia/algoritma. Properti CspStatuses berbeda dari metode GetCspStatuses . Metode ini memungkinkan Anda mengatur parameter KeySpec , tetapi CspStatuses menggunakan properti KeySpec yang diatur pada kunci privat yang terkait dengan objek IX509CertificateRequestPkcs10 . Ini bisa menjadi salah satu nilai berikut.

Nilai Deskripsi
XCN_AT_NONE Hanya PENYEDIA Cryptography API: Next Generation (CNG) yang dipilih.
XCN_AT_KEYEXCHANGE Hanya penyedia layanan kriptografi (CSP) CryptoAPI dengan algoritma enkripsi (termasuk pertukaran kunci) yang dipilih.
XCN_AT_SIGNATURE Hanya penyedia layanan kriptografi (CSP) CryptoAPI dengan algoritma tanda tangan yang dipilih.
 

Jika Anda menentukan templat saat menginisialisasi objek permintaan, atribut templat seperti pKIDefaultCSPs dan pKIDefaultKeySpec memengaruhi pasangan penyedia/algoritma mana yang awalnya diaktifkan dalam koleksi. Anda dapat memanggil properti berikut pada setiap objek ICspStatus untuk mengambil informasi tentang sepasang:

Koleksi yang diambil oleh metode ini disimpan secara internal pada objek permintaan. Koleksi ada selama objek PKCS #10 terus ada.

Misalnya, properti KeySpec pada kunci privat yang terkait dengan objek permintaan diatur ke XCN_AT_SIGNATURE dan templat digunakan untuk menginisialisasi permintaan. Pernyataan berikut akan benar:

  • Kumpulan objek ICspStatus dibuat dan disimpan pada objek IX509CertificateRequestPkcs10 . Koleksi berisi semua pasangan penyedia/algoritma yang valid yang terinstal pada komputer.
  • Karena properti KeySpec tidak diatur ke XCN_AT_NONE, properti Terpilih diatur ke SelectedNo untuk setiap API Kriptografi: pasangan penyedia/algoritma Generasi Berikutnya (CNG) dalam koleksi.
  • Karena properti KeySpec tidak diatur ke XCN_AT_KEYEXCHANGE, properti Terpilih diatur ke SelectedNo untuk setiap pasangan CSP/algoritma CryptoAPI dalam koleksi tempat algoritma hanya dapat digunakan untuk mengenkripsi data atau mengarsipkan kunci.
  • Untuk setiap penyedia yang direferensikan oleh templat atau kunci privat tetapi tidak didukung di komputer, objek ICspStatus tempat penampung dibuat dan ditambahkan ke koleksi dan properti Dipilih diatur ke SelectedNo.
  • Properti Dipilih diatur ke SelectedYes untuk setiap pasangan CSP/algoritma CryptoAPI di mana algoritma hanya dapat digunakan untuk menandatangani data.
  • Properti Ordinal diatur untuk mencerminkan urutan CSP, jika ada, yang diidentifikasi oleh atribut templat pKIDefaultCSPs . CSP yang dicantumkan pertama kali oleh atribut diurutkan terlebih dahulu dalam koleksi. Properti ini digunakan selama pendaftaran jika kunci privat harus dibuat. Pasangan CSP/algoritma pertama yang dipilih digunakan untuk membuat kunci, tetapi jika operasi gagal, pasangan yang dipilih berikutnya akan dicoba.

Anda harus menginisialisasi objek IX509CertificateRequestPkcs10 sebelum memanggil metode ini. Untuk informasi selengkapnya, lihat salah satu metode berikut:

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header certenroll.h
DLL CertEnroll.dll

Lihat juga

ICspAlgorithm

ICspAlgorithms

ICspInformation

ICspInformations

ICspStatus

IX509CertificateRequestPkcs10