ISignerCertificate::Initialize method (certenroll.h)

Artikel
08/22/2023

Metode Inisialisasi menginisialisasi objek dari sertifikat penandatanganan.

Sintaks

HRESULT Initialize(
  [in] VARIANT_BOOL         MachineContext,
  [in] X509PrivateKeyVerify VerifyType,
  [in] EncodingType         Encoding,
  [in] BSTR                 strCertificate
);

Parameter

[in] MachineContext

Variabel VARIANT_BOOL yang menunjukkan apakah akan mencari konteks penyimpanan sertifikat komputer lokal atau konteks pengguna untuk menemukan sertifikat yang diidentifikasi oleh parameter strCertificate . Tentukan VARIANT_TRUE untuk komputer dan VARIANT_FALSE untuk pengguna.

[in] VerifyType

Nilai enumerasi X509PrivateKeyVerify yang menentukan apakah kunci privat yang digunakan untuk menandatangani sertifikat harus diverifikasi dan, jika demikian, apakah verifikasi harus diam atau memungkinkan input pengguna.

[in] Encoding

Nilai enumerasi EncodingType yang menentukan jenis pengodean Unicode yang diterapkan ke string sertifikat yang dikodekan Distinguished Encoding Rules (DER).

[in] strCertificate

Variabel BSTR yang berisi sertifikat yang dikodekan DER.

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.
Parameter MachineContext menentukan apakah pengguna atau penyimpanan komputer atau keduanya dicari.
Jika kunci privat diperlukan, hanya penyimpanan pribadi dan permintaan yang dicari.
Jika kunci privat tidak diperlukan, penyimpanan OS akar dan menengah juga dicari.

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.

Mengembalikan kode/nilai	Deskripsi
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Objek ISignerCertificate telah diinisialisasi.

Keterangan

Metode Inisialisasi :

Memverifikasi apakah kunci privat yang terkait dengan sertifikat ada.
Membuat objek IX509SignatureInformation dan menetapkannya ke objek ISignerCertificate .
Mengambil algoritma kunci publik dari kunci privat.
Menetapkan algoritma kunci publik ke objek IX509SignatureInformation .

Atur properti berikut sebelum memanggil Inisialisasi:

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

ISignerCertificate

Bagikan melalui