Share via

Metode ICertProperty::RemoveFromCertificate (certenroll.h)

  • Artikel

Metode RemoveFromCertificate memisahkan properti dari sertifikat. Tentukan properti yang akan dihapus dengan memanggil properti PropertyId .

Sintaks

HRESULT RemoveFromCertificate(
  [in] VARIANT_BOOL MachineContext,
  [in] EncodingType Encoding,
  [in] BSTR         strCertificate
);

Parameter

[in] MachineContext

Nilai VARIANT_BOOL yang menunjukkan apakah penyimpanan sertifikat terletak di komputer lokal. Tentukan VARIANT_TRUE jika penyimpanan bersifat lokal.

[in] Encoding

Nilai enumerasi EncodingType yang menentukan jenis pengodean yang diterapkan ke string sertifikat yang diidentifikasi oleh parameter strCertificate .

[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
CRYPT_E_NOT_FOUND
 Sertifikat tidak dapat ditemukan.
CRYPT_E_UNEXPECTED_MSG_TYPE
 Sertifikat ditemukan tetapi kunci privat tidak dapat dimuat.

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

ICertProperties

ICertProperty