IDirectorySearch::AbandonSearch-Methode (iads.h)
Die IDirectorySearch::AbandonSearch-Methode gibt eine Suche ab, die durch einen früheren Aufruf der ExecuteSearch-Methode initiiert wurde.
Syntax
HRESULT AbandonSearch(
[in] ADS_SEARCH_HANDLE phSearchResult
);
Parameter
[in] phSearchResult
Stellt ein Handle für den Suchkontext bereit.
Rückgabewert
Diese Methode gibt die Standardrückgabewerte zurück, einschließlich S_OK, wenn die erste Zeile erfolgreich abgerufen wurde.
Weitere Rückgabewerte finden Sie unter ADSI-Fehlercodes.
Hinweise
IDirectorySearch::AbandonSearch kann verwendet werden, wenn die Page_Size- oder asynchronen Optionen über IDirectorySearch::SetSearchPreference angegeben werden können, bevor die Suche ausgeführt wird.
Beispiele
LPWSTR pszAttr[] = { L"ADsPath", L"Name", L"samAccountName" };
ADS_SEARCH_HANDLE hSearch;
DWORD dwCount= sizeof(pszAttr)/sizeof(LPWSTR);
////////////////////////////////////////////////////////////////////
// NOTE: Assume that m_pSearch is an IDirectorySearch pointer to the
// object at the base of the search, and that the appropriate search
// preferences have been set.
// For brevity, omit error handling.
////////////////////////////////////////////////////////////////////
// Search for all users with a last name that starts with h.
hr = m_pSearch->ExecuteSearch(L"(&(objectClass=user)(sn=h*))", pszAttr, dwCount, &hSearch );
while( m_pSearch->GetNextRow( hSearch) != S_ADS_NOMORE_ROWS )
{
// Get the samAccountName
hr = m_pSearch->GetColumn( hSearch, pszAttr[2], &col );
if ( FAILED(hr) )
{
hr = m_pSearch->AbandonSearch( hSearch );
hr = m_pSearch->CloseSearchHandle(hSearch);
m_pSearch->Release();
break;
}
if (col.dwADsType == ADSTYPE_CASE_IGNORE_STRING)
printf("%S\n", col.pADsValues->CaseIgnoreString);
m_pSearch->FreeColumn( &col );
}
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 |