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

IDirectorySearch::CloseSearchHandle 메서드는 검색 결과에 대한 핸들을 닫고 연결된 메모리를 해제합니다.

구문

HRESULT CloseSearchHandle(
  [in] ADS_SEARCH_HANDLE hSearchResult
);

매개 변수

[in] hSearchResult

닫을 검색 결과에 대한 핸들을 제공합니다.

반환 값

이 메서드는 표준 반환 값과 다음을 반환합니다.

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

설명

IDirectorySearch::CloseSearchHandle 메서드를 구현하는 프로세스는 검색 결과 및 검색 결과 핸들을 포함하여 IDirectorySearch::ExecuteSearch 메서드에 의해 할당된 모든 메모리를 해제해야 합니다.

호출자는 열린 각 검색 핸들에 대해 이 메서드를 한 번만 호출할 수 있으며 IDirectorySearch::ExecuteSearch 메서드를 사용하여 IDirectorySearch::CloseSearchHandle을 실행한 후 새 검색 핸들을 가져와야 합니다.

예제

ADS_SEARCH_HANDLE hSearch;
HRESULT hr;
hr = m_pSearch->ExecuteSearch(L"(&(objectCategory=user)(l=Redmond))", pszAttr, dwCount, &hSearch );
if ( SUCCEEDED(hr) )
{
   // Omit getting the data
   m_pSearch->CloseSearchHandle(hSearch);
}

요구 사항

추가 정보

ADSI 오류 코드

IDirectorySearch

IDirectorySearch::ExecuteSearch