IDirectorySearch::GetFirstRow-Methode (iads.h)
Die GetFirstRow-Methode ruft die erste Zeile eines Suchergebnisses ab. Diese Methode stellt 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 den Suchhandpunkt, der 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 ADS_SEARCHPREF_CACHE_RESULTS Flag nicht festgelegt ist, also FALSE, ist nur vorwärts scrollen zulässig, da der Client möglicherweise nicht alle Abfrageergebnisse zwischenspeichert. Das Aufrufen von GetFirstRow erfordert mehr als einmal aus derselben Zeile einen Back-Scrolling und kann zu fehlerhaften Ergebnissen für eine seiteige oder eine 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
| 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 |