IDirectorySearch::GetNextRow-Methode (iads.h)

Artikel
08/24/2023

Die GetNextRow-Methode ruft die nächste Zeile des Suchergebnisses ab. Wenn IDirectorySearch::GetFirstRow nicht aufgerufen wurde, gibt GetNextRow eine neue Suche aus, beginnend mit der ersten Zeile. Andernfalls wechselt diese Methode zur nächsten Zeile.

Syntax

HRESULT GetNextRow(
  [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, ist nur vorwärts scrollen zulässig, da der Client möglicherweise nicht alle Abfrageergebnisse zwischenspeichert.

Der Verzeichnisanbieter kann die maximale Anzahl von Zeilen einschränken, die in einer Suche verfügbar sind. In einer Windows-Domäne beträgt die maximale Anzahl von Zeilen, die in einer Active Directory-Suche bereitgestellt werden, 1.000 Zeilen. Wenn die Suchergebnisse den Zeilengrenzwert überschreiten, muss eine ausgelagerte Suche ausgeführt werden, um alle Zeilen in der Suche abzurufen. Weitere Informationen zu ausgelagerten Suchvorgängen finden Sie unter Paging mit IDirectorySearch.

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


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