Metode ICertRequest2::GetFullResponseProperty (certcli.h)

Artikel
03/14/2023

Metode GetFullResponseProperty mengambil data respons cache yang dikembalikan oleh server.

Sintaks

HRESULT GetFullResponseProperty(
  [in]  LONG    PropId,
  [in]  LONG    PropIndex,
  [in]  LONG    PropType,
  [in]  LONG    Flags,
  [out] VARIANT *pvarPropertyValue
);

Parameter

[in] PropId

Data yang akan diambil. Jika properti diindeks, gunakan PropIndex untuk menentukan indeks. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
FR_PROP_NONE 0	Tidak ada data.
FR_PROP_FULLRESPONSE 1	Semua data yang di-cache diambil (data biner).
FR_PROP_STATUSINFOCOUNT 2	Jumlah respons dalam data cache (properti panjang dan terindeks).
FR_PROP_BODYPARTSTRING 3	Data hierarki (string, properti terindeks).
FR_PROP_STATUS 4	Nilai status permintaan (properti panjang dan terindeks).
FR_PROP_STATUSSTRING 5	String status permintaan (string, properti terindeks).
FR_PROP_OTHERINFOCHOICE 6	Pilihan untuk informasi lain (properti panjang dan terindeks). Ini bisa menjadi salah satu nilai berikut. CMC_OTHER_INFO_NO_CHOICE CMC_OTHER_INFO_FAIL_CHOICE CMC_OTHER_INFO_PEND_CHOICE
FR_PROP_FAILINFO 7	Informasi kegagalan permintaan (properti panjang dan terindeks).
FR_PROP_PENDINFOTOKEN 8	Token permintaan tertunda (biner, properti terindeks).
FR_PROP_PENDINFOTIME 9	Tanggal permintaan tertunda (DATE, properti terindeks).
FR_PROP_ISSUEDCERTIFICATEHASH 10	Hash sertifikat yang dikeluarkan diambil (properti biner, terindeks).
FR_PROP_ISSUEDCERTIFICATE 11	Sertifikat yang dikeluarkan diambil (biner, properti terindeks).
FR_PROP_ISSUEDCERTIFICATECHAIN 12	Sertifikat yang dikeluarkan (biner, properti terindeks).
FR_PROP_ISSUEDCERTIFICATECRLCHAIN 13	Rantai sertifikat yang dikeluarkan (biner, properti terindeks).
FR_PROP_ENCRYPTEDKEYHASH 14	Hash kunci terenkripsi (biner, properti terindeks).
FR_PROP_FULLRESPONSENOPKCS7 15	Semua data yang di-cache diambil kecuali untuk PKCS #7 (biner).
FR_PROP_CAEXCHANGECERTIFICATEHASH 16	Hash sertifikat pertukaran CA.
FR_PROP_CAEXCHANGECERTIFICATE 17	Sertifikat pertukaran CA.
FR_PROP_CAEXCHANGECERTIFICATECHAIN 18	Rantai sertifikat pertukaran CA.
FR_PROP_CAEXCHANGECERTIFICATECRLCHAIN 19	Rantai CLR sertifikat pertukaran CA.
FR_PROP_ATTESTATIONCHALLENGE 20	Respons tantangan pengesahan kunci
FR_PROP_ATTESTATIONPROVIDERNAME 21	Nama penyedia penyimpanan kunci untuk pengesahan kunci.

[in] PropIndex

Indeks berbasis nol saat PropId adalah properti terindeks. Jika PropId bukan properti terindeks, maka PropIndex harus nol.

[in] PropType

Jenis data yang dikembalikan dalam pvarPropertyValue. Jenis properti di sini harus cocok dengan jenis data yang ditentukan oleh parameter PropId .

Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
PROPTYPE_LONG 1	Data panjang yang ditandatangani.
PROPTYPE_DATE 2	Data tanggal (termasuk tanggal dan waktu).
PROPTYPE_BINARY 3	Data biner.
PROPTYPE_STRING 4	Data string.

[in] Flags

Format data yang dikembalikan dalam pvarPropertyValue. Bendera yang diatur di sini harus cocok dengan jenis data yang ditentukan oleh parameter PropId .

Untuk informasi selengkapnya, lihat Keterangan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CR_OUT_BASE64HEADER 0	Format BASE64 dengan header begin/end.
CR_OUT_BASE64 1	Format BASE64 tanpa header awal/akhir.
CR_OUT_BINARY 2	Format biner.

[out] pvarPropertyValue

Data dikembalikan.

Mengembalikan nilai

C++

Jika metode berhasil, metode mengembalikan S_OK dan pvarPropertyValue berisi data yang dikembalikan.

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

VB

Nilai yang dikembalikan adalah Varian yang berisi data yang dikembalikan.

Keterangan

Nilai PropId berikut mengembalikan data biner, yang berarti bahwa parameter Bendera harus diatur ke CR_OUT_BINARY:

FR_PROP_FULLRESPONSE
FR_PROP_ISSUEDCERTIFICATEHASH
FR_PROP_ISSUEDCERTIFICATE
FR_PROP_ISSUEDCERTIFICATECHAIN
FR_PROP_ISSUEDCERTIFICATECRLCHAIN
FR_PROP_ENCRYPTEDKYEHASH
FR_PROP_FULLRESPONSENOPKCS7

Metode ini dipanggil setelah metode ICertRequest3::Submit atau ICertRequest3::RetrievePending telah dipanggil. Metode ini mengisi data cache yang dikembalikan oleh GetFullResponseProperty.

Setelah metode ICertRequest3::GetFullResponseProperty mengembalikan datanya, metode berikut dapat dipanggil:

ICEnroll4::AcceptResponse dapat dipanggil untuk menginstal sertifikat yang dikembalikan.
ICEnroll4::GetCertFromResponse dapat dipanggil untuk mengurai sertifikat dari respons.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	certcli.h (termasuk Certsrv.h)
Pustaka	Certidl.lib
DLL	Certcli.dll

Bagikan melalui