IEnumCERTVIEWCOLUMN::Lewati metode (certview.h)

Artikel
02/23/2024

Metode Lewati melewati jumlah kolom tertentu dalam urutan enumerasi kolom.

Sintaks

HRESULT Skip(
  [in] LONG celt
);

Parameter

[in] celt

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

Nilai kembali

VB

Jika metode berhasil, metode mengembalikan S_OK.

Nilai pengembalian E_INVALIDARG menunjukkan bahwa nilai negatif dalam parameter celt menyebabkan indeks urutan enumerasi kolom 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 fungsi ini, panggil metode IEnumCERTVIEWCOLUMN::Next untuk mereferensikan kolom saat ini dalam urutan enumerasi kolom. Setelah panggilan kedua ini dilakukan, informasi di kolom dapat diperoleh dengan memanggil salah satu metode berikut:

IEnumCERTVIEWCOLUMN::GetName: Mengambil nama kolom yang tidak dilokalisasi.
IEnumCERTVIEWCOLUMN::GetDisplayName: Mengambil nama kolom yang dilokalkan.
IEnumCERTVIEWCOLUMN::GetValue: Mengambil data di kolom .
IEnumCERTVIEWCOLUMN::GetType: Mengambil jenis data dalam kolom.
IEnumCERTVIEWCOLUMN::GetMaxLength: Mengambil panjang maksimum, dalam byte, dari kolom.

Urutan enumerasi kolom mempertahankan indeks internal berbasis nol. 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

HRESULT  hr;
LONG     Index;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
// skip the next five columns
hr = pEnumCol->Skip(5);
if (S_OK == hr) 
{
    // get the next column
    hr = pEnumCol->Next(&Index);
    if (S_OK == hr)
    {
        // Use this column as needed.
    }
}

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

Lihat juga

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWCOLUMN::Reset

IEnumCERTVIEWCOLUMN:Berikutnya

Bagikan melalui