Metode IEnumCERTVIEWROW::EnumCertViewAttribute (certview.h)

Artikel
03/14/2023

Metode EnumCertViewAttribute mendapatkan instans urutan enumerasi atribut untuk baris urutan enumerasi baris saat ini.

Sintaks

HRESULT EnumCertViewAttribute(
  [in]  LONG                   Flags,
  [out] IEnumCERTVIEWATTRIBUTE **ppenum
);

Parameter

[in] Flags

C++	Nilai LONG . Harus nol.
VB	Nilai Panjang . Harus nol.

[out] ppenum

Penunjuk ke penunjuk jenis IEnumCERTVIEWATTRIBUTE . Setelah berhasil menyelesaikan metode ini, ppenum diatur ke penunjuk jenis IEnumCERTVIEWATTRIBUTE .

Mengembalikan nilai

C++

Jika metode berhasil, metode akan mengembalikan S_OK.

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

VB

Nilai yang dikembalikan adalah objek urutan enumerasi atribut.

Keterangan

Urutan enumerasi atribut yang diperoleh oleh panggilan ini dapat digunakan untuk menghitung atribut yang terkait dengan sertifikat di baris saat ini. Enumerasi ini dapat diakses melalui metode antarmuka IEnumCERTVIEWATTRIBUTE .

Untuk mereferensikan baris yang berbeda, panggil salah satu metode berikut untuk menavigasi melalui urutan enumerasi baris:

IEnumCERTVIEWROW::Reset: Berpindah ke awal urutan enumerasi.
IEnumCERTVIEWROW::Next: Berpindah ke baris berikutnya dalam urutan enumerasi.
IEnumCERTVIEWROW::Skip: Melewati jumlah baris tertentu.

Contoh

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT                  hr;
LONG                     Index;
IEnumCERTVIEWATTRIBUTE * pEnumAttr = NULL;

// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute(0, &pEnumAttr);
if (FAILED(hr))
{
    printf("Failed EnumCertViewAttribute - %x\n", hr);
    goto error;
}
// enumerate each attribute
while (S_OK == pEnumAttr->Next(&Index))
{
    // Use this attribute as needed.
}
error:

// Free resources.
if (NULL != pEnumAttr)
    pEnumAttr->Release();

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