IEnumCERTVIEWATTRIBUTE::Lewati metode (certview.h)

  • Artikel

Metode Lewati melewati sejumlah atribut tertentu dalam urutan enumerasi atribut.

Sintaks

HRESULT Skip(
  [in] LONG celt
);

Parameter

[in] celt

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

Nilai kembali

VB

Jika metode berhasil, metode akan mengembalikan S_OK.

Nilai pengembalian E_INVALIDARG menunjukkan bahwa nilai negatif untuk parameter celt menyebabkan indeks urutan enumerasi atribut 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 IEnumCERTVIEWATTRIBUTE::Next untuk mereferensikan atribut saat ini dalam urutan enumerasi atribut. Nama dan nilai atribut dapat diakses melalui metode berikut:

Urutan enumerasi atribut mempertahankan indeks berbasis nol internal. Panggilan ke metode Lewati menyebabkan indeks ini meningkat atau berkurang dengan jumlah atribut yang ditentukan dalam parameter celt .

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

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

Contoh

HRESULT  hr;
LONG     Index;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
// skip the next 5 attributes
hr = pEnumAttr->Skip(5);
if (S_OK == hr)
{
    // get the next attribute
    hr = pEnumAttr->Next(&Index);
    if (S_OK == hr)
    {
        // Use this attribute 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

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWATTRIBUTE::Reset

IEnumCERTVIEWATTRIBUTE:Berikutnya