Metode IEnumCERTVIEWATTRIBUTE::GetValue (certview.h)

Artikel
02/26/2024

Metode GetValue mengambil nilai atribut saat ini dalam urutan atribut-enumerasi.

Sintaks

HRESULT GetValue(
  [out] BSTR *pstrOut
);

Parameter

[out] pstrOut

Penunjuk ke jenis BSTR yang berisi nilai atribut .

Menampilkan nilai

C++

Jika metode berhasil, metode mengembalikan S_OK dan pstrOut diatur ke nilai atribut saat ini.

Untuk menggunakan metode ini, buat variabel jenis BSTR , atur variabel yang sama dengan NULL, dan teruskan alamat variabel ini sebagai pstrOut. Setelah Anda selesai menggunakan BSTR, bebaskan dengan memanggil fungsi SysFreeString .

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

VB

Nilai yang dikembalikan adalah String yang mewakili nilai atribut saat ini.

Keterangan

Metode ini digunakan untuk mengambil data dalam atribut yang saat ini direferensikan oleh urutan enumerasi atribut.

Jika urutan atribut-enumerasi tidak mereferensikan atribut yang valid, GetValue akan gagal. Gunakan salah satu metode berikut untuk menavigasi melalui enumerasi:

IEnumCERTVIEWATTRIBUTE::Reset: Berpindah ke awal urutan enumerasi.
IEnumCERTVIEWATTRIBUTE::Next: Berpindah ke atribut berikutnya dalam urutan enumerasi.
IEnumCERTVIEWATTRIBUTE::Skip: Melewati sejumlah atribut tertentu.

Contoh

BSTR    bstrAttribValue = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetValue(&bstrAttribValue);
if (S_OK != hr)
    printf("Failed call to GetValue - %x\n", hr);
else
    printf("Attribute value is %ws\n",bstrAttribValue);

// free memory when done
if (NULL != bstrAttribValue)
    SysFreeString(bstrAttribValue);

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