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

El método IDirectorySearch::CloseSearchHandle cierra el identificador a un resultado de búsqueda y libera la memoria asociada.

Sintaxis

HRESULT CloseSearchHandle(
  [in] ADS_SEARCH_HANDLE hSearchResult
);

Parámetros

[in] hSearchResult

Proporciona un identificador para el resultado de búsqueda que se va a cerrar.

Valor devuelto

Este método devuelve los valores devueltos estándar, así como los siguientes:

Para obtener otros valores devueltos, consulta Códigos de error ADSI.

Comentarios

El proceso que implementa el método IDirectorySearch::CloseSearchHandle también debe ser responsable de liberar toda la memoria asignada por el método IDirectorySearch::ExecuteSearch , incluido el resultado de búsqueda y el identificador del resultado de búsqueda.

El autor de la llamada puede llamar a este método una sola vez para cada identificador de búsqueda abierto y debe usar el método IDirectorySearch::ExecuteSearch para obtener un nuevo identificador de búsqueda después de emitir IDirectorySearch::CloseSearchHandle.

Ejemplos

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

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	iads.h
Archivo DLL	Activeds.dll; Adsldp.dll; Adsldpc.dll

Consulte también

Códigos de error adsi

IDirectorySearch

IDirectorySearch::ExecuteSearch