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
| 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 |