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 |