IDirectorySearch::GetFirstRow-Methode (iads.h)

Die GetFirstRow-Methode ruft die erste Zeile eines Suchergebnisses ab. Diese Methode gibt eine neue Suche aus oder führt sie erneut aus, auch wenn diese Methode zuvor aufgerufen wurde.

Syntax

HRESULT GetFirstRow(
  [in] ADS_SEARCH_HANDLE hSearchResult
);

Parameter

[in] hSearchResult

Enthält das Suchhandle, das durch Aufrufen von IDirectorySearch::ExecuteSearch abgerufen wird.

Rückgabewert

Diese Methode gibt die Standardrückgabewerte sowie folgendes zurück:

Weitere Informationen finden Sie unter ADSI-Fehlercodes.

Hinweise

Wenn das flag ADS_SEARCHPREF_CACHE_RESULTS nicht festgelegt ist, d. h. FALSE, ist nur vorwärts scrollen zulässig, da der Client möglicherweise nicht alle Abfrageergebnisse zwischenspeichert. Der Aufruf von GetFirstRow mehr als einmal aus derselben Zeile erfordert einen gewissen Rücklauf und kann zu fehlerhaften Ergebnissen für eine ausgelagerte oder asynchrone Suche führen, die über OLE DB initiiert wurde, wenn die Ergebnisse nicht garantiert im Cache verbleiben.

Beispiele

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

Anforderungen

Weitere Informationen

ADSI-Fehlercodes

Idirectorysearch

IDirectorySearch::ExecuteSearch