Método IDirectorySearch::CloseSearchHandle (iads.h)

O método IDirectorySearch::CloseSearchHandle fecha o identificador para um resultado de pesquisa e libera a memória associada.

Sintaxe

HRESULT CloseSearchHandle(
  [in] ADS_SEARCH_HANDLE hSearchResult
);

Parâmetros

[in] hSearchResult

Fornece um identificador para o resultado da pesquisa a ser fechado.

Retornar valor

Esse método retorna os valores de retorno padrão, bem como o seguinte:

Para outros valores retornados, consulte Códigos de erro ADSI.

Comentários

O processo que implementa o método IDirectorySearch::CloseSearchHandle também deve ser responsável por liberar toda a memória alocada pelo método IDirectorySearch::ExecuteSearch , incluindo o resultado da pesquisa e o identificador de resultado da pesquisa.

O chamador pode chamar esse método apenas uma vez para cada identificador de pesquisa aberto e deve usar o método IDirectorySearch::ExecuteSearch para obter um novo identificador de pesquisa depois de emitir IDirectorySearch::CloseSearchHandle.

Exemplos

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

Requisitos

Confira também

Códigos de erro ADSI

Idirectorysearch

IDirectorySearch::ExecuteSearch