Méthode IDirectorySearch ::CloseSearchHandle (iads.h)
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 |