IX509Enrollment::CreateRequest method (certenroll.h)

Artikel
03/14/2023

Metode CreateRequest mengambil permintaan sertifikat yang dikodekan. Permintaan sertifikat terkandung dalam array byte yang dikodekan dengan menggunakan Distinguished Encoding Rules (DER) seperti yang didefinisikan oleh standar Abstract Syntax Notation One (ASN.1). Array byte yang dikodekan DER diwakili oleh string yang merupakan urutan biner murni atau dikodekan Unicode. Metode ini diaktifkan web.

Sintaks

HRESULT CreateRequest(
  [in]  EncodingType Encoding,
  [out] BSTR         *pValue
);

Parameter

[in] Encoding

Nilai enumerasi EncodingType yang menentukan jenis pengodean Unicode yang diterapkan ke permintaan yang dikodekan DER. Nilai defaultnya adalah XCN_CRYPT_STRING_BASE64.

[out] pValue

Pointer ke variabel BSTR yang berisi permintaan yang dikodekan DER.

Mengembalikan nilai

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.

Mengembalikan kode/nilai	Deskripsi
CERTSRV_E_PROPERTY_EMPTY	Permintaan sertifikat tidak dapat ditemukan.
OLE_E_BLANK	Objek pendaftaran belum diinisialisasi.

Keterangan

Metode CreateRequest memanggil metode Encode , jika perlu, untuk mengodekan data mentah dari objek permintaan terkait.

Metode ini menggunakan informasi yang diberikan selama inisialisasi dan properti lain yang telah ditentukan, membuat sertifikat dummy dan menempatkannya di penyimpanan permintaan. Metode ini juga membuat pasangan kunci jika perlu. Bergantung pada cara Anda menginisialisasi objek pendaftaran dan pada properti apa yang Anda tetapkan, mungkin tidak perlu membuat pasangan kunci. Misalnya, jika Anda memperbarui sertifikat dengan menggunakan kunci yang ada, atau jika objek IX509PrivateKey yang terkait dengan permintaan sertifikat mewakili kunci yang ada, metode ini tidak membuat pasangan kunci baru.

Jika kartu pintar terlibat, metode ini mengodekan properti eksternal sebagai ekstensi, menyertakannya dalam sertifikat dummy, dan menulis sertifikat dummy ke kontainer kunci kartu pintar. Sertifikat masuk smartcard dikodekan ke penyimpanan permintaan, bukan penyimpanan pribadi.

Sebelum memanggil metode CreateRequest , Anda harus menginisialisasi objek IX509Enrollment dengan memanggil 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

IX509CertificateRequest

Pendaftaran IX509

Bagikan melalui