Метод IDirectorySearch::GetFirstRow (iads.h)

Статья
03/05/2024

Метод GetFirstRow получает первую строку результата поиска. Этот метод будет выдавать или повторно выдавать новый поиск, даже если этот метод был вызван ранее.

Синтаксис

HRESULT GetFirstRow(
  [in] ADS_SEARCH_HANDLE hSearchResult
);

Параметры

[in] hSearchResult

Содержит дескриптор поиска, полученный путем вызова IDirectorySearch::ExecuteSearch.

Возвращаемое значение

Этот метод возвращает стандартные возвращаемые значения, а также следующие:

Дополнительные сведения см. в разделе Коды ошибок ADSI.

Если флаг ADS_SEARCHPREF_CACHE_RESULTS не задан, т. е. FALSE, разрешена только прямая прокрутка, так как клиент может не кэшировать все результаты запроса. Вызов GetFirstRow несколько раз из одной строки требует некоторой обратной прокрутки и может привести к ошибочным результатам для страничного или асинхронного поиска, инициированного через OLE DB, когда результаты не гарантированно останутся в кэше.

Примеры

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);
}

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	iads.h
DLL	Activeds.dll; Adsldp.dll; Adsldpc.dll

См. также раздел

Коды ошибок ADSI

IDirectorySearch

IDirectorySearch::ExecuteSearch

Поделиться через