IDirectorySearch::AbandonSearch 메서드(iads.h)

  • 아티클

IDirectorySearch::AbandonSearch 메서드는 ExecuteSearch 메서드에 대한 이전 호출로 시작된 검색을 중단합니다.

구문

HRESULT AbandonSearch(
  [in] ADS_SEARCH_HANDLE phSearchResult
);

매개 변수

[in] phSearchResult

검색 컨텍스트에 대한 핸들을 제공합니다.

반환 값

이 메서드는 첫 번째 행을 성공적으로 가져온 경우 S_OK 포함하여 표준 반환 값을 반환합니다.

다른 반환 값은 ADSI 오류 코드를 참조하세요.

설명

검색이 실행되기 전에 IDirectorySearch::SetSearchPreference를 통해 Page_Size 또는 비동기 옵션을 지정할 수 있는 경우 IDirectorySearch::AbandonSearch를 사용할 수 있습니다.

예제

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

요구 사항

   
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 iads.h
DLL Activeds.dll; Adsldp.dll; Adsldpc.dll

참고 항목

ADSI 오류 코드

IDirectorySearch

IDirectorySearch::ExecuteSearch

IDirectorySearch::SetSearchPreference