Metode IX509AttributeArchiveKey::InitializeEncode (certenroll.h)

Artikel
03/14/2023

Metode InitializeEncode menginisialisasi atribut dari objek IX509PrivateKey , sertifikat enkripsi otoritas sertifikasi , dan pengidentifikasi objek algoritma enkripsi simetris (OID).

Sintaks

HRESULT InitializeEncode(
  [in]           IX509PrivateKey *pKey,
  [in]           EncodingType    Encoding,
  [in]           BSTR            strCAXCert,
  [in, optional] IObjectId       *pAlgorithm,
  [in]           LONG            EncryptionStrength
);

Parameter

[in] pKey

Penunjuk ke antarmuka IX509PrivateKey yang mewakili kunci.

[in] Encoding

Nilai enumerasi EncodingType yang menentukan jenis pengodean Unicode yang diterapkan ke string input yang berisi kunci terenkripsi.

[in] strCAXCert

Variabel BSTR yang berisi sertifikat enkripsi otoritas sertifikasi yang berisi kunci publik yang digunakan untuk mengenkripsi kunci privat.

Dimulai dengan Windows 7 dan Windows Server 2008 R2, Anda dapat menentukan cetak jempol sertifikat atau nomor seri daripada sertifikat yang dikodekan. Melakukannya menyebabkan fungsi mencari penyimpanan lokal yang sesuai untuk sertifikat yang cocok. Perlu diingat poin-poin berikut:

BSTR harus berupa jumlah digit heksadesimal yang merata.
Spasi putih antara pasangan heksadesimal diabaikan.
Parameter Pengodean harus diatur ke XCN_CRYPT_STRING_HEXRAW.
Hanya penyimpanan pribadi dan permintaan yang dicari untuk kunci privat.

[in, optional] pAlgorithm

Penunjuk ke antarmuka IObjectId yang mewakili OID algoritma enkripsi simetris yang digunakan untuk mengenkripsi kunci privat. Parameter ini bersifat opsional. Jika Anda tidak menyediakan OID, XCN_OID_RSA_DES_EDE3_CBC (Triple DES) akan digunakan.

[in] EncryptionStrength

Variabel LONG yang berisi kekuatan enkripsi algoritma yang diidentifikasi oleh parameter pAlgorithm . Parameter ini saat ini tidak digunakan karena SDK Pendaftaran Sertifikat tidak mendukung algoritma apa pun yang OID-nya belum menyiratkan kekuatan (panjang kunci). Misalnya, AES memiliki beberapa kekuatan tetapi kekuatan masing-masing sudah ditunjukkan oleh OID.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

Pengidentifikasi objek untuk atribut ini XCN_OID_ARCHIVED_KEY_ATTR (1.3.6.1.4.1.311.21.13). Untuk informasi selengkapnya, lihat CERTENROLL_OBJECTID.

Anda harus memanggil InitializeEncode atau InitializeDecode sebelum Anda dapat menggunakan objek IX509AttributeArchiveKey . Kedua metode saling melengkapi. Metode InitializeEncode memungkinkan Anda membuat struktur Abstract Syntax Notation One (ASN.1) yang dikodekan dari data mentah, dan metode InitializeDecode memungkinkan Anda menginisialisasi data mentah dari struktur ASN.1 yang dikodekan. Anda dapat memanggil properti berikut untuk mengambil data 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

IX509AttributeArchiveKey

Bagikan melalui