Metode IDirectorySearch::GetNextRow (iads.h)
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 |