Metode IX509ExtensionKeyUsage::InitializeEncode (certenroll.h)

  • Artikel

Metode InitializeEncode menginisialisasi ekstensi dengan menggunakan enumerasi X509KeyUsageFlags . Metode ini diaktifkan web.

Sintaks

HRESULT InitializeEncode(
  [in] X509KeyUsageFlags UsageFlags
);

Parameter

[in] UsageFlags

Nilai enumerasi X509KeyUsageFlags . Ini bisa menjadi kombinasi bitwise-OR dari salah satu nilai berikut.

Nilai Makna
XCN_CERT_DIGITAL_SIGNATURE_KEY_USAGE
 Kunci digunakan dengan Digital Signature Algorithm (DSA) untuk mendukung layanan selain nonrepudiasi, penandatanganan sertifikat, atau penandatanganan daftar pencabutan. DSA sering digunakan untuk autentikasi.
XCN_CERT_NON_REPUDIATION_KEY_USAGE
 Kunci digunakan untuk memverifikasi tanda tangan digital sebagai bagian dari layanan nonrepudiasi yang melindungi dari penolakan tindakan palsu oleh entitas penandatanganan.
XCN_CERT_KEY_ENCIPHERMENT_KEY_USAGE
 Kunci digunakan untuk transportasi kunci. Artinya, kunci digunakan untuk mengelola kunci yang diteruskan dari titik asalnya ke titik penggunaan aktualnya.
XCN_CERT_DATA_ENCIPHERMENT_KEY_USAGE
 Kunci digunakan untuk mengenkripsi data pengguna selain kunci kriptografi.
XCN_CERT_KEY_AGREEMENT_KEY_USAGE
 Kunci digunakan untuk perjanjian kunci. Perjanjian kunci atau protokol pertukaran kunci memungkinkan dua pihak atau lebih untuk menegosiasikan nilai kunci tanpa mentransfer kunci dan tanpa sebelumnya membuat rahasia bersama.
XCN_CERT_KEY_CERT_SIGN_KEY_USAGE
 Kunci digunakan untuk memverifikasi tanda tangan sertifikat. Nilai ini hanya dapat digunakan untuk sertifikat yang dikeluarkan oleh otoritas sertifikasi.
XCN_CERT_OFFLINE_CRL_SIGN_KEY_USAGE
 Kunci digunakan untuk memverifikasi tanda tangan daftar pencabutan sertifikat offline (CRL).
XCN_CERT_CRL_SIGN_KEY_USAGE
 Kunci digunakan untuk memverifikasi tanda tangan CRL.
XCN_CERT_ENCIPHER_ONLY_KEY_USAGE
 Kunci digunakan untuk mengenkripsi data saat melakukan perjanjian kunci. Nilai XCN_CERT_KEY_AGREEMENT_KEY_USAGE juga harus ditentukan.
XCN_CERT_DECIPHER_ONLY_KEY_USAGE
 Kunci digunakan untuk mendekripsi data saat melakukan perjanjian kunci. Nilai XCN_CERT_KEY_AGREEMENT_KEY_USAGE juga harus ditentukan.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Menampilkan kode Deskripsi
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Objek sudah diinisialisasi.

Keterangan

Anda harus memanggil InitializeEncode atau InitializeDecode sebelum Anda dapat menggunakan objek IX509ExtensionKeyUsage . Kedua metode saling melengkapi. Metode InitializeEncode memungkinkan Anda membuat objek ekstensi Abstract Syntax Notation One (ASN.1) yang dikodekan Distinguished Encoding Rules (DER) dari data mentah, dan metode InitializeDecode memungkinkan Anda menginisialisasi data mentah dari objek yang dikodekan.

Anda dapat mengambil properti berikut untuk ekstensi ini:

  • Properti Kritis mengidentifikasi apakah ekstensi sangat penting. Anda juga dapat menentukan properti ini.
  • Properti ObjectId mengambil pengidentifikasi objek ekstensi (OID).
  • Properti KeyUsage mengambil pembatasan yang mengidentifikasi penggunaan kunci umum yang dimaksudkan (data ekstensi mentah).

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

IX509ExtensionKeyUsage