IEnumCERTVIEWATTRIBUTE::Metode berikutnya (certview.h)

Artikel
02/23/2024

Metode Berikutnya berpindah ke atribut berikutnya dalam urutan enumerasi atribut.

Sintaks

HRESULT Next(
  [out] LONG *pIndex
);

Parameter

[out] pIndex

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

Menampilkan nilai

C++

Jika metode berhasil, metode mengembalikan S_OK dan atribut berikutnya sekarang direferensikan oleh urutan enumerasi atribut. Jika tidak ada atribut lagi, metode mengembalikan S_FALSE, 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 atribut yang sekarang direferensikan oleh urutan enumerasi atribut. Jika tidak ada lagi atribut untuk dijumlahkan, nilai yang dikembalikan adalah –1.

Keterangan

Setelah berhasil menyelesaikan metode ini, nama dan nilai atribut dapat diakses melalui metode berikut:

Contoh

LONG       Index;
HRESULT    hr;
BSTR       bstrAttribName = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
while (S_OK == pEnumAttr->Next(&Index))
{
    // retrieve the attribute name
    hr = pEnumAttr->GetName(&bstrAttribName);
    if (FAILED(hr))
        printf("Failed GetName -  %x\n", hr );
    else
        printf("Attribute name: %ws\n", bstrAttribName);
}

// Free resources.
if (NULL != bstrAttribName)
    SysFreeString(bstrAttribName);

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