Метод 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