Metode ICertConfig::GetField (certcli.h)

Artikel
03/14/2023

Metode GetField mendapatkan bidang tertentu dari rekaman database konfigurasi saat ini. Metode ini pertama kali didefinisikan dalam antarmuka ICertConfig .

Sintaks

HRESULT GetField(
  [in]          const BSTR strFieldName,
  [out, retval] BSTR       *pstrOut
);

Parameter

[in] strFieldName

Menentukan nama bidang yang akan dikembalikan. Parameter ini dapat menjadi salah satu string yang valid berikut untuk nama bidang (perhatikan bahwa beberapa otoritas sertifikasi mungkin tidak menyediakan data untuk setiap bidang).

Nilai	Makna
Otoritas	Nama otoritas sertifikasi referensi (CA).
CommonName	Nama umum server.
Konfigurasi	Referensi nama komputer\CA.
Negara	Negara/wilayah.
Deskripsi	Komentar deskriptif tentang server (menggantikan "Komentar" usang).
ExchangeCertificate	Nama file yang berisi sertifikat pertukaran (hanya berlaku untuk Certificate Services 1.0).
Bendera	String yang mewakili lokasi tempat informasi CA ditemukan. Untuk informasi selengkapnya, lihat Keterangan.
Wilayah	Kota atau kota.
Organisasi	Organisasi.
OrgUnit	Unit organisasi.
SanitizedName	Nama CA yang dibersihkan sesuai dengan aturan yang dijelaskan dalam GetConfig.
SanitizedShortName	Nama CA yang dibersihkan dan disingkat sesuai dengan aturan yang dijelaskan dalam GetConfig.
Server	Nama komputer referensi.
ShortName	SanitizedShortName, tetapi dengan urutan '!xxx', seperti yang dijelaskan dalam GetConfig, diterjemahkan kembali ke teks asli.
SignatureCertificate	Nama file yang berisi sertifikat CA (juga dikenal sebagai sertifikat tanda tangan CA); ini mungkin atau mungkin bukan sertifikat akar.
Provinsi	Negara bagian atau provinsi.
WebEnrollmentServers	Array URL layanan Web pendaftaran sertifikat untuk konfigurasi CA tertentu di Direktori Aktif. Windows Vista dan Windows Storage Server 2003: Bidang ini tidak didukung.

[out, retval] pstrOut

Pointer ke BSTR yang menerima data dari bidang . Setelah Anda selesai menggunakan BSTR, gratiskan pbstrOut dengan memanggil fungsi SysFreeString .

Mengembalikan nilai

C++

Jika metode berhasil, metode akan 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 string yang mewakili data untuk bidang .

Keterangan

Metode ini mengembalikan data bidang untuk bidang yang ditentukan.

Saat Anda menentukan "Bendera" dalam parameter strFieldName , data yang diambil untuk bidang bendera adalah string yang dapat dikonversi menjadi bilangan bulat dengan fungsi pustaka C _wtoi. Bilangan bulat yang dihasilkan mewakili bitfield yang dapat diperiksa untuk menentukan apakah bendera CAIF_DSENTRY dan CAIF_SHAREDFOLDERENTRY diatur. Jika CAIF_DSENTRY (0x00000001) diatur, informasi untuk CA terkandung dalam Layanan Direktori. Jika CAIF_SHAREDFOLDERENTRY (0x00000002) diatur, informasi untuk CA terkandung dalam folder bersama. Perhatikan bahwa salah satu atau kedua bendera ini dapat diatur.

Contoh

    BSTR  bstrFieldName = NULL;
    BSTR  bstrFieldValue = NULL;
    HRESULT    hr;

    // Specify the field to retrieve, for example, "CommonName".
    bstrFieldName = SysAllocString(L"<FIELDNAMEHERE>");
    if (NULL == bstrFieldName)
    {
        printf("Memory allocation failed for bstrFieldName.\n");
        goto error;
    }

    // pConfig is a previously instantiated ICertConfig object.
    hr = pConfig->GetField(bstrFieldName, &bstrFieldValue);
    if (FAILED(hr))
    {
        printf("Failed GetField - [%x]\n", hr);
        goto error;
    }
    else
        printf("GetField value for %ws is: %ws\n", 
            bstrFieldName, bstrFieldValue );

error:

    if (bstrFieldName)
        SysFreeString(bstrFieldName);

    if (bstrFieldValue)
        SysFreeString(bstrFieldValue);

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

CCertConfig

ICertConfig

Bagikan melalui