IEnumCERTVIEWROW::Lewati metode (certview.h)

Artikel
03/14/2023

Metode Lewati melewati jumlah baris tertentu dalam urutan enumerasi baris.

Sintaks

HRESULT Skip(
  [in] LONG celt
);

Parameter

[in] celt

Jumlah baris yang akan dilewati. Nilai positif untuk parameter celt menyebabkan urutan enumerasi baris dilewati ke depan dalam urutan enumerasi. Nilai negatif untuk parameter celt menyebabkan urutan enumerasi baris melewati mundur dalam urutan enumerasi.

Nilai kembali

VB

Jika metode berhasil, metode mengembalikan S_OK.

Nilai pengembalian E_INVALIDARG menunjukkan bahwa parameter celt diatur ke angka negatif yang menyebabkan indeks urutan enumerasi baris menjadi kurang dari nol.

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

Keterangan

Setelah berhasil menyelesaikan metode ini, panggil metode IEnumCERTVIEWROW::Skip untuk mereferensikan baris saat ini dalam urutan enumerasi baris. Setelah panggilan kedua ini dilakukan, kolom, atribut, dan ekstensi yang terkait dengan sertifikat dalam baris dapat dijumlahkan menggunakan metode antarmuka berikut:

Urutan enumerasi baris mempertahankan indeks berbasis nol internal. Panggilan ke metode Lewati menyebabkan indeks ini meningkat atau berkurang berdasarkan pengaturan parameter celt .

Jika nilai negatif parameter celt menyebabkan indeks kurang dari nol, perilaku panggilan berikutnya ke Berikutnya tidak terdefinisi.

Jika nilai positif parameter celt menyebabkan indeks melebihi baris terakhir dalam urutan enumerasi, panggilan berikutnya ke metode Berikutnya akan gagal.

Contoh

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
HRESULT  hr;
LONG     Index;
// Reposition the row enumerator to the beginning of the rows.
hr = pEnumRow->Reset();
if (FAILED(hr))
{
    printf("Unable to reset pEnumRow\n");
    goto error;
}
// Skip some rows.
hr = pEnumRow->Skip(5);
if (FAILED(hr))
{
    printf("Unable to skip rows\n");
    goto error;
}

// Get the next row.
hr = pEnumRow->Next(&Index);
if (S_OK == hr)
{
    // Use this row as needed.
}

error:

if (NULL != pEnumRow)
    pEnumRow->Release();

Persyaratan


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