Metode IEnumCERTVIEWCOLUMN::GetDisplayName (certview.h)

Artikel
03/14/2023

Metode GetDisplayName mengambil nama kolom yang dilokalkan saat ini dalam urutan enumerasi kolom.

Sintaks

HRESULT GetDisplayName(
  [out] BSTR *pstrOut
);

Parameter

[out] pstrOut

Penunjuk ke variabel jenis BSTR yang berisi nama kolom yang dilokalkan.

Nilai kembali

C++

Jika metode berhasil, metode mengembalikan S_OK dan parameter pstrOut berisi nama kolom yang dilokalkan.

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 kolom yang dilokalkan.

Keterangan

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

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

IEnumCERTVIEWCOLUMN::Reset: Berpindah ke awal urutan enumerasi.
IEnumCERTVIEWCOLUMN::Next: Berpindah ke kolom berikutnya dalam urutan enumerasi.
IEnumCERTVIEWCOLUMN::Skip: Melewati jumlah kolom tertentu.

Contoh

BSTR     bstrDisplay = NULL;
HRESULT  hr;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object.
hr = pEnumCol->GetDisplayName(&bstrDisplay);
if (S_OK == hr)
    printf("Column name is %ws\n", bstrDisplay);

// Done processing, clear resources.
if (NULL != bstrDisplay)
    SysFreeString(bstrDisplay);

Persyaratan


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