Metodo IDirectorySearch::CloseSearchHandle (iads.h)

Il metodo IDirectorySearch::CloseSearchHandle chiude l'handle a un risultato di ricerca e libera la memoria associata.

Sintassi

HRESULT CloseSearchHandle(
  [in] ADS_SEARCH_HANDLE hSearchResult
);

Parametri

[in] hSearchResult

Fornisce un handle per il risultato della ricerca da chiudere.

Valore restituito

Questo metodo restituisce i valori restituiti standard, nonché i seguenti:

Per altri valori restituiti, vedere Codici di errore ADSI.

Commenti

Il processo che implementa il metodo IDirectorySearch::CloseSearchHandle deve anche essere responsabile della liberazione di tutta la memoria allocata dal metodo IDirectorySearch::ExecuteSearch , inclusi il risultato della ricerca e l'handle dei risultati della ricerca.

Il chiamante può chiamare questo metodo una sola volta per ogni handle di ricerca aperto e deve usare il metodo IDirectorySearch::ExecuteSearch per ottenere un nuovo handle di ricerca dopo l'emissione di IDirectorySearch::CloseSearchHandle.

Esempio

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

Requisiti

Vedi anche

Codici di errore ADSI

IDirectorySearch

IDirectorySearch::ExecuteSearch