Bagikan melalui

Metode ICspStatus::get_Ordinal (certenroll.h)

  • Artikel

Properti Ordinal menentukan atau mengambil posisi objek ICspStatus dalam koleksi ICspStatuses .

Properti ini bersifat baca/tulis.

Sintaks

HRESULT get_Ordinal(
  LONG *pValue
);

Parameter

pValue

Nilai kembali

Tidak ada

Keterangan

Untuk melakukan iterasi melalui koleksi ICspStatuses berdasarkan ordinal, panggil properti ItemByOrdinal . Urutan ordinal objek ICspStatus dalam koleksi dapat bervariasi setiap kali koleksi dijumlahkan karena berbagai alasan termasuk, tetapi tidak terbatas pada, yang berikut ini:

  • Pengaturan templat permintaan sertifikat
  • Nilai properti untuk penyedia kriptografi
  • Nilai properti kunci privat

Misalnya, asumsikan bahwa templat versi 2 yang dipilih untuk membuat permintaan sertifikat menentukan bahwa sertifikat hanya dapat digunakan untuk penandatanganan (atribut templat pKIDefaultKeySpec XCN_AT_SIGNATURE) dan bahwa penyedia default adalah Penyedia Kriptografi Microsoft Enhanced RSA dan AES. Perhatikan bahwa templat membatasi sertifikat untuk ditandatangani meskipun penyedia mendukung algoritma enkripsi dan penandatanganan. Artinya, properti KeySpec pada penyedia adalah kombinasi bitwise dari konstanta XCN_AT_KEYEXCHANGE dan XCN_AT_SIGNATURE, tetapi atribut templat pKIDefaultKeySpec hanya mendukung XCN_AT_SIGNATURE.

Objek ICspStatus dalam koleksi akan diurutkan dengan cara berikut:

  • Dari objek ICspStatus yang dijumlahkan untuk penyedia ini, yang terkait dengan algoritma tanda tangan (XCN_AT_SIGNATURE) diurutkan terlebih dahulu (nilai ordinal yang lebih rendah) dan properti Tampilan dan Terpilih diaktifkan.
    Catatan Jika atribut templat pKIDefaultKeySpec telah XCN_AT_KEYEXCHANGE, algoritma enkripsi akan diurutkan terlebih dahulu.
     
  • Dari objek ICspStatus yang dijumlahkan untuk penyedia ini, objek yang terkait dengan algoritma enkripsi (XCN_AT_KEYEXCHANGE) diurutkan nanti (nilai ordinal yang lebih tinggi) dan properti Tampilan dan Terpilih tidak diaktifkan.
  • Untuk semua penyedia CryptoAPI terinstal lainnya yang mendukung algoritma penandatanganan asimetris (XCN_AT_SIGNATURE) tetapi yang tidak terkait dengan penyedia yang ditentukan, properti Tampilan diaktifkan dan properti Dipilih tidak diaktifkan.
  • Untuk semua penyedia CryptoAPI terinstal lainnya yang mendukung algoritma enkripsi asimetris (XCN_AT_KEYEXCHANGE), properti Tampilan dan Terpilih tidak diaktifkan.
  • Untuk semua penyedia Cryptography API yang diinstal: Next Generation (CNG), properti Display dan Selected tidak diaktifkan.

Untuk contoh lain, asumsikan bahwa templat versi 3 menentukan satu penyedia dan algoritma CNG tertentu. Pasangan penyedia/algoritma (objek ICspStatus ) diurutkan terlebih dahulu, diaktifkan untuk tampilan dan dipilih. Semua algoritma lain yang didukung oleh penyedia tersebut diurutkan nanti, tidak diaktifkan untuk ditampilkan, dan tidak dipilih. Semua penyedia lain yang mendukung algoritma yang ditentukan akan diurutkan nanti, diaktifkan untuk tampilan, tetapi tidak dipilih. Semua pasangan penyedia/algoritma yang tersisa tidak akan diaktifkan untuk tampilan dan tidak dipilih.

Catatan Penyedia CNG tidak mendukung konsep penggunaan yang dimaksudkan KeySpec . Mereka mengembalikan XCN_AT_NONE untuk nilai properti ini.

 

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

ICspStatus

ICspStatuses