IDirectorySearch::GetFirstRow-Methode (iads.h)

Artikel
02/26/2024

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h
DLL	Activeds.dll; Adsldp.dll; Adsldpc.dll

Weitere Informationen

ADSI-Fehlercodes

Idirectorysearch

IDirectorySearch::ExecuteSearch