IEnumCERTVIEWATTRIBUTE::Metode GetName (certview.h)

Artikel
02/23/2024

Metode GetName mengambil nama atribut saat ini dalam urutan atribut-enumerasi.

Sintaks

HRESULT GetName(
  [out] BSTR *pstrOut
);

Parameter

[out] pstrOut

Penunjuk ke variabel jenis BSTR yang berisi nama atribut .

Menampilkan nilai

C++

Jika metode berhasil, metode mengembalikan S_OK dan parameter pstrOut berisi nama atribut .

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 berisi nama atribut .

Keterangan

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

Jika urutan enumerasi atribut tidak mereferensikan atribut yang valid, GetName 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    bstrAttribName = NULL;

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

// free memory when done
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