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

Lihat juga

Kode Kesalahan ADSI

IDirectorySearch

IDirectorySearch::ExecuteSearch