Metode IEnumCERTVIEWROW::EnumCertViewExtension (certview.h)

Artikel
03/13/2024

Metode EnumCertViewExtension mendapatkan instans urutan enumerasi ekstensi untuk baris urutan enumerasi baris saat ini.

Sintaks

HRESULT EnumCertViewExtension(
  [in]          LONG                   Flags,
  [out, retval] IEnumCERTVIEWEXTENSION **ppenum
);

Parameter

[in] Flags

C++	Nilai LONG . Harus nol.
VB	Nilai panjang . Harus nol.

[out, retval] ppenum

Penunjuk ke penunjuk jenis IEnumCERTVIEWEXTENSION .

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 objek urutan enumerasi ekstensi.

Keterangan

Urutan enumerasi ekstensi yang diperoleh oleh panggilan ini dapat digunakan untuk menghitung ekstensi yang terkait dengan sertifikat di baris saat ini. Enumerasi ini dapat diakses melalui metode antarmuka IEnumCERTVIEWEXTENSION .

Untuk mereferensikan baris yang berbeda, panggil salah satu metode berikut untuk menavigasi melalui urutan enumerasi baris:

IEnumCERTVIEWROW::Reset: Berpindah ke awal urutan enumerasi.
IEnumCERTVIEWROW::Next: Berpindah ke baris berikutnya dalam urutan enumerasi.
IEnumCERTVIEWROW::Skip: Melewati jumlah baris tertentu.

Contoh

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG       Index;
HRESULT    hr;
IEnumCERTVIEWEXTENSION * pEnumExt = NULL;
// Obtain enumerator for extensions.
hr = pEnumRow->EnumCertViewExtension(0, &pEnumExt);
if (FAILED(hr))
{
    printf("Failed EnumCertViewExtension - %x\n", hr);
    goto error;
}
// Enumerate each extension.
while (S_OK == pEnumExt->Next(&Index))
{
    // Use this extension as needed.
}
error:

// Free resources.
if (NULL != pEnumExt)
    pEnumExt->Release();

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	certview.h (termasuk Certsrv.h)
Pustaka	Certidl.lib
DLL	Certadm.dll