Metode ICertRequest2::GetCAProperty (certcli.h)

Artikel
03/14/2023

Metode GetCAProperty mengambil nilai properti untuk otoritas sertifikasi (CA). Fungsionalitas metode ini identik dengan ICertAdmin2::GetCAProperty. Untuk informasi tentang metode ini, lihat ICertAdmin2::GetCAProperty.

Sintaks

HRESULT GetCAProperty(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [in]          LONG       PropIndex,
  [in]          LONG       PropType,
  [in]          LONG       Flags,
  [out, retval] VARIANT    *pvarPropertyValue
);

Parameter

[in] strConfig

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

[in] PropId

Menentukan pengidentifikasi properti. Untuk informasi tentang parameter ini, lihat tabel di ICertAdmin2::GetCAProperty.

[in] PropIndex

Jika PropId diindeks, indeks berbasis nol yang akan digunakan saat mengambil nilai properti. Jika PropId tidak diindeks, nilai ini diabaikan.

[in] PropType

Menentukan jenis properti , yang terkait dengan kolom Jenis dalam tabel PropId . Jenisnya bisa menjadi salah satu jenis berikut.

Nilai	Makna
PROPTYPE_LONG	Data panjang yang ditandatangani
PROPTYPE_DATE	Tanggal/waktu (dicadangkan untuk penggunaan di masa mendatang)
PROPTYPE_BINARY	Data biner
PROPTYPE_STRING	Data untai (karakter) Unicode

[in] Flags

Bendera berikut dapat digunakan untuk menentukan format nilai properti yang dikembalikan; bendera ini hanya memiliki arti untuk data biner (seperti sertifikat, rantai sertifikat, atau daftar pencabutan sertifikat) dan diabaikan sebaliknya.

Nilai	Makna
CV_OUT_BASE64	BASE64 tanpa BEGIN/END
CV_OUT_BASE64HEADER	BASE64 dengan BEGIN CERTIFICATE dan END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 dengan BEGIN NEW CERTIFICATE REQUEST dan END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 dengan BEGIN X509 CRL dan END X509 CRL
CV_OUT_BINARY	Biner
CV_OUT_HEX	String heksadesimal
CV_OUT_HEXADDR	String heksadesimal dengan alamat/offset
CV_OUT_HEXASCII	String heksadesimal dengan ASCII
CV_OUT_HEXASCIIADDR	String heksadesimal dengan ASCII dan alamat/offset

[out, retval] pvarPropertyValue

Penunjuk ke VARIAN yang menerima nilai properti yang diminta.

Setelah Anda selesai menggunakan VARIAN, bebaskan dengan memanggil fungsi VariantClear .

Mengembalikan nilai

C++

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.

VB

Nilai yang dikembalikan adalah Varian yang menerima nilai properti yang diminta.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
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

Lihat juga

CCertRequest

ICertRequest

ICertRequest2

Bagikan melalui