Metode ICertAdmin::SetCertificateExtension (certadm.h)

Artikel
08/22/2023

Metode SetCertificateExtension menambahkan ekstensi baru ke sertifikat yang dikeluarkan sebagai respons terhadap permintaan sertifikat. Metode ini pertama kali didefinisikan oleh antarmuka ICertAdmin .

Agar metode ini berhasil, permintaan sertifikat harus tertunda.

Sintaks

HRESULT SetCertificateExtension(
  [in] const BSTR    strConfig,
  [in] LONG          RequestId,
  [in] const BSTR    strExtensionName,
  [in] LONG          Type,
  [in] LONG          Flags,
  [in] const VARIANT *pvarValue
);

Parameter

[in] strConfig

Mewakili string konfigurasi yang valid untuk server otoritas sertifikasi (CA) dalam bentuk COMPUTERNAME\CANAME, di mana COMPUTERNAME adalah nama jaringan server Layanan Sertifikat dan CANAME adalah nama umum otoritas sertifikasi, seperti yang dimasukkan selama penyiapan Layanan Sertifikat. Untuk informasi tentang nama string konfigurasi, lihat ICertConfig.

SetCertificateExtensionpenting tidak menghapus cache internal saat string konfigurasi diubah. Saat Anda mengubah string konfigurasi untuk CA, Anda harus membuat instans objek ICertAdmin baru dan memanggil metode ini lagi dengan string konfigurasi baru.

[in] RequestId

Menentukan ID permintaan sertifikat.

[in] strExtensionName

Menentukan pengidentifikasi objek (OID) untuk ekstensi yang akan diatur. Panjang string harus 31 karakter non-NULL atau lebih sedikit.

[in] Type

Menentukan jenis ekstensi yang sedang disetel. Parameter Jenis harus setuju dengan jenis data parameter pvarValue . Jenis data ini diatur dalam bidang vt dari struktur VARIAN .

Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
PROPTYPE_LONG	Data panjang yang ditandatangani
PROPTYPE_DATE	Tanggal/Waktu
PROPTYPE_BINARY	Nilai ekstensi diatur apa adanya dan diasumsikan sebagai ASN.1 yang dikodekan jika perlu.
PROPTYPE_STRING	Nilai ekstensi akan dikodekan ASN.1 sebagai string IA5 sebelum ditempatkan dalam sertifikat baru. Catatan Anda harus menggunakan PROPTYPE_STRING untuk nilai ekstensi yang terdiri dari satu URL hanya jika Anda ingin URL dikodekan secara otomatis sebagai string IA5. Jika tidak, kodekan URL sebagai string IA5 sendiri dan teruskan nilai yang dikodekan sebagai PROPTYPE_BINARY.

[in] Flags

Menentukan bendera untuk ekstensi yang sedang diatur. Jika tidak ada bendera yang akan diatur, gunakan nilai nol. Anda dapat menggabungkan bendera ini dengan operasi bitwise-OR dan juga dengan bendera ekstensi privat kebijakan (8 bit tinggi dari bidang EXTENSION_POLICY_MASK).

Catatan Ketika parameter Bendera diatur ke EXTENSION_DISABLE_FLAG, ekstensi akan dinonaktifkan di log server dan tidak akan ditambahkan ke sertifikat.

Nilai	Makna
EXTENSION_CRITICAL_FLAG	Ini adalah ekstensi penting.
EXTENSION_DISABLE_FLAG	Ekstensi tidak akan digunakan.

[in] pvarValue

Menentukan nilai yang terkait dengan ekstensi.

Nilai kembali

VB

Jika metode berhasil, metode mengembalikan S_OK.

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

Keterangan

Tugas administrasi menggunakan DCOM. Kode yang memanggil metode antarmuka ini seperti yang didefinisikan dalam versi Certadm.h sebelumnya akan berjalan pada server berbasis Windows selama klien dan server menjalankan sistem operasi Windows yang sama.

Persyaratan


Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	certadm.h (termasuk Certsrv.h)
Pustaka	Certidl.lib
DLL	Certadm.dll

Lihat juga