IEnumCERTVIEWCOLUMN::Metode berikutnya (certview.h)

Artikel
03/14/2023

Metode Berikutnya berpindah ke kolom berikutnya dalam urutan enumerasi kolom.

Sintaks

HRESULT Next(
  [out] LONG *pIndex
);

Parameter

[out] pIndex

Penunjuk ke variabel yang berisi nilai indeks kolom berikutnya yang direferensikan oleh urutan enumerasi kolom. Jika tidak ada lagi kolom untuk dijumlahkan, variabel ini diatur ke –1. Metode ini akan gagal jika pIndex adalah NULL.

Nilai kembali

C++

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

Keterangan

Setelah berhasil menyelesaikan metode ini, informasi dalam kolom dapat diperoleh dengan memanggil salah satu metode berikut:

IEnumCERTVIEWCOLUMN::GetName: Mengambil nama kolom yang tidak dilokalisasi.
IEnumCERTVIEWCOLUMN::GetDisplayName: Mengambil nama kolom yang dilokalkan.
IEnumCERTVIEWCOLUMN::GetValue: Mengambil data di kolom .
IEnumCERTVIEWCOLUMN::GetType: Mengambil jenis data dalam kolom.
IEnumCERTVIEWCOLUMN::GetMaxLength: Mengambil panjang maksimum, dalam byte, dari kolom.

Contoh

LONG       nLength;
LONG       nType;
LONG       bIsindexed;
LONG       Index;

HRESULT    hr;

BSTR       bstrColName = NULL;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
// examine each column
while (S_OK == pEnumCol->Next(&Index))
{
    // determine database length
    hr = pEnumCol->GetMaxLength(&nLength);
    if (FAILED(hr))
    {
        printf("Failed GetMaxLength %x\n", hr);
        goto error;
    }

    // determine data type
    hr = pEnumCol->GetType(&nType);
    if (FAILED(hr))
    {
        printf("Failed GetType %x\n", hr);
        goto error;
    }

    // determine whether column is indexed
    hr = pEnumCol->IsIndexed(&bIsindexed);
    if (FAILED(hr))
    {
        printf("Failed IsIndexed %x\n", hr);
        goto error;
    }

    // retrieve column name
    hr = pEnumCol->GetName(&bstrColName);
    if (FAILED(hr))
    {
        printf("Failed GetName %x\n", hr);
        goto error;
    }

    // print this column's info on one line
    // print name and length
    printf("Column %ws has max length %d",
            bstrColName,
            nLength); 

    // print data type
    switch (nType)
    {
        case PROPTYPE_BINARY:
            printf(" Type is Binary");
            break;
        case PROPTYPE_DATE:
            printf(" Type is Date+Time");
            break;
        case PROPTYPE_LONG:
            printf(" Type is Signed long");
            break;
        case PROPTYPE_STRING:
            printf(" Type is Unicode String");
            break;
        default:
            printf(" Type is unknown");
            break;
    }

    // print index status
    printf(bIsindexed ? " Indexed" : " Not indexed");
    // print new line marker
    printf("\n");

}

error:

// done processing, clear resources
if (NULL != bstrColName)
    SysFreeString(bstrColName);

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