Metode IDirectorySearch::GetFirstRow (iads.h)
Metode GetFirstRow mendapatkan baris pertama dari hasil pencarian. Metode ini akan mengeluarkan atau menerbitkan ulang pencarian baru, bahkan jika metode ini telah dipanggil sebelumnya.
Sintaks
HRESULT GetFirstRow(
[in] ADS_SEARCH_HANDLE hSearchResult
);
Parameter
[in] hSearchResult
Berisi handel pencarian yang diperoleh dengan memanggil IDirectorySearch::ExecuteSearch.
Nilai kembali
Metode ini mengembalikan nilai pengembalian standar, serta yang berikut ini:
Untuk informasi selengkapnya, lihat Kode Kesalahan ADSI.
Keterangan
Ketika bendera ADS_SEARCHPREF_CACHE_RESULTS tidak diatur, yaitu FALSE, hanya pengguliran terusan yang diizinkan, karena klien mungkin tidak menyimpan semua hasil kueri. Memanggil GetFirstRow lebih dari sekali dari baris yang sama memerlukan beberapa pengguliran kembali dan dapat mengakibatkan hasil yang salah untuk pencarian halaman atau asinkron yang dimulai melalui OLE DB ketika hasilnya tidak dijamin tetap berada di cache.
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
Persyaratan | Nilai |
---|---|
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 |