Bagikan melalui

Metode ICertRequest2::GetFullResponseProperty (certcli.h)

  • Artikel

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:

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