Metode IDirectorySearch::GetNextRow (iads.h)

Artikel
08/24/2023

Metode GetNextRow mendapatkan baris berikutnya dari hasil pencarian. Jika IDirectorySearch::GetFirstRow belum dipanggil, GetNextRow akan mengeluarkan pencarian baru yang dimulai dari baris pertama. Jika tidak, metode ini akan maju ke baris berikutnya.

Sintaks

HRESULT GetNextRow(
  [in] ADS_SEARCH_HANDLE hSearchResult
);

Parameter

[in] hSearchResult

Berisi handel pencarian yang diperoleh dengan memanggil IDirectorySearch::ExecuteSearch.

Mengembalikan nilai

Metode ini mengembalikan nilai pengembalian standar, serta yang berikut ini:

Untuk informasi selengkapnya, lihat Kode Kesalahan ADSI.

Keterangan

Saat bendera ADS_SEARCHPREF_CACHE_RESULTS tidak diatur, hanya pengguliran ke depan yang diizinkan, karena klien mungkin tidak menyimpan semua hasil kueri.

Penyedia direktori dapat membatasi jumlah maksimum baris yang tersedia dalam pencarian. Misalnya, pada domain Windows, jumlah maksimum baris yang akan disediakan dalam pencarian Direktori Aktif adalah 1000 baris. Jika pencarian menghasilkan lebih dari batas baris, pencarian halaman harus dilakukan untuk mendapatkan semua baris dalam pencarian. Untuk informasi selengkapnya tentang pencarian halaman, lihat Halaman dengan IDirectorySearch.

Contoh

hr = m_pSearch->ExecuteSearch(L"(objectCategory=contact)", pszAttr, dwCount, &hSearch);
if(SUCCEEDED(hr))
{
    while(SUCCEEDED(hr = m_pSearch->GetNextRow(hSearch)))
    {
        if(S_OK == hr)
        {
            // Get the data.
        }
        else if(S_ADS_NOMORE_ROWS == hr)
        {
            // Call ADsGetLastError to see if the search is waiting for a response.
            DWORD dwError = ERROR_SUCCESS;
            WCHAR szError[512];
            WCHAR szProvider[512];

            ADsGetLastError(&dwError, szError, 512, szProvider, 512);
            if(ERROR_MORE_DATA != dwError)
            {
                break;
            }
        }
        else
        {
            break;
        }
    }
    
    m_pSearch->CloseSearchHandle(hSearch);
}

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	iads.h
DLL	Activeds.dll; Adsldp.dll; Adsldpc.dll