IDirectorySearch::CloseSearchHandle メソッド (iads.h)

IDirectorySearch::CloseSearchHandle メソッドは、ハンドルを検索結果に閉じ、関連付けられているメモリを解放します。

構文

HRESULT CloseSearchHandle(
  [in] ADS_SEARCH_HANDLE hSearchResult
);

パラメーター

[in] hSearchResult

閉じる検索結果へのハンドルを提供します。

戻り値

このメソッドは、標準の戻り値と、次の値を返します。

その他の戻り値については、「 ADSI エラー コード」を参照してください。

注釈

IDirectorySearch::CloseSearchHandle メソッドを実装するプロセスは、検索結果や検索結果ハンドルを含め、IDirectorySearch::ExecuteSearch メソッドによって割り当てられたすべてのメモリを解放する必要もあります。

呼び出し元は、開いている各検索ハンドルに対して 1 回だけこのメソッドを呼び出すことができます。 IDirectorySearch::CloseSearchHandle を発行した後に新しい検索ハンドルを取得するには 、IDirectorySearch::ExecuteSearch メソッドを使用する必要があります。

例

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

要件

こちらもご覧ください

ADSI エラー コード

IDirectorySearch

IDirectorySearch::ExecuteSearch