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 |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für