Metode ICertAdmin2::GetCAProperty (certadm.h)
Metode GetCAProperty mengambil nilai properti untuk otoritas sertifikasi (CA). Metode ini pertama kali didefinisikan dalam antarmuka ICertAdmin .
Sintaks
HRESULT GetCAProperty(
[in] const BSTR strConfig,
[in] LONG PropId,
[in] LONG PropIndex,
[in] LONG PropType,
[in] LONG Flags,
[out] 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 salah satu pengidentifikasi properti berikut.
| Nilai | Makna |
|---|---|
|
Jenis data properti: Panjang Menentukan apakah CA menjalankan Server Tingkat Lanjut. |
|
Jenis data properti: Biner, terindeks Daftar pencabutan sertifikat (CRL) lengkap, atau dasar CA. |
|
Jenis data properti: Panjang, terindeks Status penerbitan CRL dasar. Untuk mengetahui detail selengkapnya, harap lihat Keterangan. |
|
Jenis data properti: Biner, terindeks Sertifikat silang mundur. Sertifikat silang mundur adalah sertifikat yang dikeluarkan setelah perpanjangan dari CA ke dirinya sendiri yang ditandatangani dengan kunci baru CA. Sertifikat silang mundur memiliki pengidentifikasi kunci otoritas sertifikat CA baru dan pengidentifikasi kunci subjek sertifikat CA lama. Hanya berlaku untuk CA akar. |
|
Jenis data properti: Panjang, terindeks Apakah sertifikat silang mundur valid. Hanya berlaku untuk CA akar. |
|
Jenis data properti: Panjang Status sertifikat CA. Nilainya dapat berupa:
|
|
Jenis data properti: Panjang, terindeks Status sertifikat CA, sebagai HRESULT. |
|
Jenis data properti: Panjang, terindeks Versi sertifikat CA, sebagai DWORD. Kata urutan tinggi adalah indeks kunci, dan kata urutan rendah adalah indeks sertifikat CA. |
|
Jenis data properti: Biner, terindeks Sertifikat silang ke depan. Sertifikat silang penerusan adalah sertifikat yang dikeluarkan setelah perpanjangan dari CA ke dirinya sendiri yang ditandatangani dengan kunci CA sebelumnya. Sertifikat silang ke depan memiliki pengidentifikasi kunci otoritas dari sertifikat CA sebelumnya dan pengidentifikasi kunci subjek sertifikat CA baru. Hanya berlaku untuk CA akar. |
|
Jenis data properti: Panjang, terindeks Apakah sertifikat silang penerusan valid. Hanya berlaku untuk CA akar. |
|
Jenis data properti: String Nama CA. |
|
Jenis data properti: Biner, terindeks Sertifikat penandatanganan CA. |
|
Jenis data properti: Biner, terindeks Rantai sertifikat penandatanganan CA. |
|
Jenis data properti: Panjang Jumlah sertifikat penandatanganan untuk CA. |
|
Jenis data properti: Biner, terindeks Rantai CRL sertifikat penandatanganan CA. |
|
Jenis data properti: Panjang Jenis CA. Ini bisa menjadi salah satu nilai berikut (didefinisikan dalam Certsrv.h):
|
|
Jenis data properti: Biner, terindeks Sertifikat pertukaran CA. |
|
Jenis data properti: Biner, terindeks Rantai sertifikat pertukaran CA. |
|
Jenis data properti: Panjang Jumlah sertifikat pertukaran untuk CA. |
|
Jenis data properti: Biner, terindeks Rantai CRL sertifikat pertukaran CA. |
|
Jenis data properti: String, terindeks Menentukan URL Akses Informasi Otoritas sebagai jenis URL yang diminta oleh klien. Windows Server 2003: Bendera ini tidak didukung. |
|
Jenis data properti: String, terindeks Menentukan URL Titik Distribusi CRL sebagai jenis URL yang diminta oleh klien. Windows Server 2003: Bendera ini tidak didukung. |
|
Jenis data properti: Panjang Status CRL CA. Nilainya dapat berupa:
|
|
Jenis data properti: Biner, terindeks CRL delta CA. |
|
Jenis data properti: Panjang, terindeks Status penerbitan CRL delta. Untuk mengetahui detail selengkapnya, harap lihat Keterangan. |
|
Jenis data properti: String Nama DNS CA. |
|
Jenis data properti: Panjang Jumlah modul keluar yang digunakan oleh CA. |
|
Jenis data properti: String Deskripsi untuk modul keluar. |
|
Jenis data properti: String Versi file Layanan Sertifikat. |
|
Jenis data properti: Biner, terindeks Sertifikat agen pemulihan kunci (KRA) CA. |
|
Jenis data properti: Panjang Jumlah sertifikat KRA untuk CA. |
|
Jenis data properti: Panjang, terindeks Status sertifikat KRA. Nilai yang dikembalikan adalah salah satu dari yang berikut ini:
|
|
Jenis data properti: Panjang Jumlah sertifikat KRA yang digunakan oleh CA. |
|
Jenis data properti: String Nama CA induk CA. |
|
Jenis data properti: String Deskripsi untuk modul kebijakan. |
|
Jenis data properti: String Versi produk tempat file dikirim. |
|
Jenis data properti: Panjang Nilai yang menentukan apakah pemisahan peran diaktifkan. |
|
Jenis data properti: String Nama CA yang dibersamakan. Untuk definisi nama CA yang dibersakan, lihat ICertConfig2::GetConfig. |
|
Jenis data properti: String Nama pendek CA yang dibersamakan. Untuk definisi nama pendek CA yang dibersamakan, lihat ICertConfig2::GetConfig. |
|
Jenis data properti: String Nama direktori folder bersama. |
|
Jenis data properti: String Daftar templat yang didukung oleh CA. |
[in] PropIndex
Jika parameter 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 ditunjukkan dalam kolom Arti dari tabel PropId . Jenisnya bisa menjadi salah satu jenis berikut.
| Nilai | Makna |
|---|---|
|
Data panjang yang ditandatangani |
|
Tanggal/waktu (dicadangkan untuk penggunaan di masa mendatang) |
|
Data biner |
|
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.
[out] pvarPropertyValue
Penunjuk ke buffer yang menerima nilai properti yang diminta. Adalah tanggung jawab penelepon untuk membebaskan sumber daya ini ketika dilakukan dengan memanggil VariantClear.
Mengembalikan nilai
C++
Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan metode berhasil.VB
Nilai properti yang diminta.Keterangan
Nilai berikut dikembalikan saat pengidentifikasi properti CR_PROP_BASECRLPUBLISHSTATUS atau CR_PROP_DELTACRLPUBLISHSTATUS. Nilai-nilai ini dapat digabungkan.
| Nilai | Deskripsi |
|---|---|
| CPF_BADURL_ERROR | URL tidak valid. |
| CPF_BASE | CRL dasar diterbitkan. |
| CPF_CASTORE_ERROR | Kesalahan penyimpanan CA mencegah publikasi. |
| CPF_COMPLETE | CRL lengkap diterbitkan. |
| CPF_DELTA | Delta CRL diterbitkan. |
| CPF_FILE_ERROR | Kesalahan file mencegah publikasi. |
| CPF_FTP_ERROR | Kesalahan FTP mencegah publikasi. |
| CPF_HTTP_ERROR | Kesalahan HTTP mencegah publikasi. |
| CPF_LDAP_ERROR | Kesalahan LDAP mencegah publikasi. |
| CPF_MANUAL | CRL diterbitkan secara manual. |
| CPF_SHADOW | CRL delta kosong diterbitkan, bersama dengan BASE CRL baru. |
| CPF_SIGNATURE_ERROR | Kesalahan tanda tangan mencegah publikasi. |
Untuk contoh pengambilan CRL, lihat Mengambil Daftar Pencabutan Sertifikat.
Contoh
Contoh berikut menunjukkan pengambilan sertifikat tanda tangan CA. Contoh mengasumsikan penunjuk antarmuka ICertAdmin2 valid.
BSTR bstrCA = NULL;
VARIANT var1;
HRESULT hr;
bstrCA = SysAllocString(L"<COMPUTERNAMEHERE>\\<CANAMEHERE>");
if (NULL == bstrCA)
{
printf("Failed to allocate memory for bstrCA\n");
exit(1);
}
VariantInit(&var1);
// Retrieve the CA signature certificate at index 0.
hr = pAdmin2->GetCAProperty(bstrCA,
CR_PROP_CASIGCERT,
0,
PROPTYPE_BINARY,
CV_OUT_BASE64HEADER,
&var1);
if (FAILED(hr))
{
printf("Failed GetCAProperty\n");
SysFreeString(bstrCA);
exit(1); // Or other error action.
}
// Use the property as needed.
// ...
// Clear the variant when finished.
VariantClear(&var1);
SysFreeString(bstrCA);
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 | certadm.h (termasuk Certsrv.h) |
| Pustaka | Certidl.lib |
| DLL | Certadm.dll |