Método IDirectorySearch::GetFirstRow (iads.h)

  • Artigo

O método GetFirstRow obtém a primeira linha de um resultado de pesquisa. Esse método emitirá ou reemitirá uma nova pesquisa, mesmo que esse método tenha sido chamado antes.

Sintaxe

HRESULT GetFirstRow(
  [in] ADS_SEARCH_HANDLE hSearchResult
);

Parâmetros

[in] hSearchResult

Contém o identificador de pesquisa obtido chamando IDirectorySearch::ExecuteSearch.

Retornar valor

Esse método retorna os valores de retorno padrão, bem como o seguinte:

Para obter mais informações, consulte Códigos de erro ADSI.

Comentários

Quando o sinalizador ADS_SEARCHPREF_CACHE_RESULTS não está definido, ou seja, FALSE, somente a rolagem para frente é permitida, pois o cliente pode não armazenar em cache todos os resultados da consulta. Chamar GetFirstRow mais de uma vez da mesma linha requer alguma rolagem de fundo e pode resultar em resultados incorretos para uma pesquisa paginada ou assíncrona iniciada por meio do OLE DB quando os resultados não têm garantia de permanecer no cache.

Exemplos

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho iads.h
DLL Activeds.dll; Adsldp.dll; Adsldpc.dll

Confira também

Códigos de erro ADSI

Idirectorysearch

IDirectorySearch::ExecuteSearch