IEnumCERTVIEWROW::Metode berikutnya (certview.h)

Artikel
02/26/2024

Metode Berikutnya berpindah ke baris berikutnya dalam urutan enumerasi baris.

Sintaks

HRESULT Next(
  [out] LONG *pIndex
);

Parameter

[out] pIndex

Penunjuk ke variabel yang berisi nilai indeks baris berikutnya yang dirujuk. Jika tidak ada lagi baris untuk dijumlahkan, variabel ini akan diatur ke –1. Metode ini gagal jika pIndex adalah NULL.

Menampilkan nilai

C++

Jika metode berhasil, metode mengembalikan S_OK dan baris berikutnya sekarang direferensikan oleh urutan enumerasi baris. Jika tidak ada lagi baris untuk dijumlahkan, S_FALSE dikembalikan, dan pIndex diatur ke nilai –1.

Jika metode gagal, metode mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

VB

Nilai yang dikembalikan adalah nilai indeks baris yang sekarang sedang direferensikan oleh urutan enumerasi baris. Jika tidak ada lagi baris untuk dijumlahkan, nilai yang dikembalikan adalah –1.

Keterangan

Setelah berhasil menyelesaikan metode ini, kolom, atribut, dan ekstensi yang terkait dengan sertifikat dalam baris dapat dijumlahkan menggunakan metode antarmuka berikut:

Mengulangi semua baris dalam urutan enumerasi dapat menjadi intensif sumber daya untuk komputasi, tergantung kueri yang terlibat dan ukuran urutan.

Contoh

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG  Index;
LONG  nCount;

// Ensure enumerator is at first row.
if (FAILED(pEnumRow->Reset()))
    printf("Failed to Reset\n");
else
{
    nCount = 0;
    // Count the database records by enumerating the rows.
    while (S_OK == pEnumRow->Next(&Index))
        nCount++;
    // Display number of records.
    printf("Number of records is %d\n", nCount);
}

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