Metode ICertAdmin2::GetCAPropertyFlags (certadm.h)

Artikel
02/26/2024

Metode GetCAPropertyFlags mengambil bendera properti untuk properti otoritas sertifikasi (CA). Metode ini pertama kali didefinisikan dalam antarmuka ICertAdmin .

Bendera properti dapat diperiksa untuk menentukan jenis data dan untuk menentukan apakah properti diindeks.

Sintaks

HRESULT GetCAPropertyFlags(
  [in]  const BSTR strConfig,
  [in]  LONG       PropId,
  [out] LONG       *pPropFlags
);

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.

PentingGetCAPropertyFlags tidak menghapus cache internal ketika string konfigurasi diubah. Saat Anda mengubah string konfigurasi untuk CA, Anda harus membuat instans objek ICertAdmin baru dan memanggil metode ini lagi dengan string konfigurasi baru.

[in] PropId

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

[out] pPropFlags

Penunjuk ke nilai yang mewakili bendera properti.

Menampilkan nilai

C++

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan metode berhasil.

VB

Long yang mewakili bendera properti.

Keterangan

Nilai LONG yang diambil dengan memanggil metode ini dapat diperiksa untuk menentukan jenis data dan status terindeks. Untuk menentukan jenis data dan status terindeks, gunakan nilai PROPTYPE_MASK dan PROPFLAGS_INDEXED.

Contoh

Contoh berikut mengasumsikan penunjuk antarmuka ICertAdmin2 valid.

BSTR bstrCA = NULL;
LONG nFlags;  // Variable to contain the property flags.

bstrCA = SysAllocString(L"<COMPUTERNAMEHERE>\\<CANAMEHERE>");
if (NULL == bstrCA)
{
    printf("Failed to allocate memory for bstrCA\n");
    exit(1);
}

// Retrieve a property's flags.
hr = pCertAdmin2->GetCAPropertyFlags(bstrCA,
                                     CR_PROP_EXITCOUNT,
                                     &nFlags);
if (FAILED(hr))
{
    printf("Failed GetCAPropertyFlags\n");
    SysFreeString(bstrCA);
    exit(1);  // Or other error action.
}
// Display the property data type.
switch (nFlags & PROPTYPE_MASK)
{
    case PROPTYPE_BINARY:
        printf("Type is BINARY\n");
        break;
    case PROPTYPE_DATE:
        printf("Type is DATE\n");
        break;
    case PROPTYPE_LONG:
        printf("Type is LONG\n");
        break;
    case PROPTYPE_STRING:
        printf("Type is STRING\n");
        break;
    default:
        printf("Unexpected data type.\n");
        break;
}
// Display the property's indexed status.
printf("Property %s indexed\n", 
       nFlags & PROPFLAGS_INDEXED ? "is" : "is not");

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

Bagikan melalui