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

  • Article

La méthode IDirectorySearch ::CloseSearchHandle ferme le handle à un résultat de recherche et libère la mémoire associée.

Syntaxe

HRESULT CloseSearchHandle(
  [in] ADS_SEARCH_HANDLE hSearchResult
);

Paramètres

[in] hSearchResult

Fournit un handle au résultat de la recherche à fermer.

Valeur retournée

Cette méthode retourne les valeurs de retour standard, ainsi que les éléments suivants :

Pour obtenir d’autres valeurs de retour, consultez Codes d’erreur ADSI.

Remarques

Le processus qui implémente la méthode IDirectorySearch ::CloseSearchHandle doit également être responsable de libérer toute la mémoire allouée par la méthode IDirectorySearch ::ExecuteSearch , y compris le résultat de la recherche et le handle de résultat de recherche.

L’appelant ne peut appeler cette méthode qu’une seule fois pour chaque handle de recherche ouvert et doit utiliser la méthode IDirectorySearch ::ExecuteSearch pour obtenir un nouveau handle de recherche après avoir émis IDirectorySearch ::CloseSearchHandle.

Exemples

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête iads.h
DLL Activeds.dll ; Adsldp.dll ; Adsldpc.dll

Voir aussi

Codes d’erreur ADSI

IDirectorySearch

IDirectorySearch ::ExecuteSearch