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

IDirectorySearch::AbandonSearch メソッドは、ExecuteSearch メソッドの以前の呼び出しによって開始された検索を破棄します。

構文

HRESULT AbandonSearch(
  [in] ADS_SEARCH_HANDLE phSearchResult
);

パラメーター

[in] phSearchResult

検索コンテキストへのハンドルを提供します。

戻り値

このメソッドは、最初の行が正常に取得された場合にS_OKを含む標準の戻り値を返します。

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

解説

IDirectorySearch::AbandonSearch は、検索を実行する前に IDirectorySearch::SetSearchPreference を使用してPage_Sizeまたは非同期オプションを指定できる場合に使用できます。

例

LPWSTR pszAttr[] = { L"ADsPath", L"Name", L"samAccountName" };
ADS_SEARCH_HANDLE hSearch;
DWORD dwCount= sizeof(pszAttr)/sizeof(LPWSTR);
////////////////////////////////////////////////////////////////////
// NOTE: Assume that m_pSearch is an IDirectorySearch pointer to the 
// object at the base of the search, and that the appropriate search 
// preferences have been set.
// For brevity, omit error handling.
////////////////////////////////////////////////////////////////////
 
// Search for all users with a last name that starts with h.
hr = m_pSearch->ExecuteSearch(L"(&(objectClass=user)(sn=h*))", pszAttr, dwCount, &hSearch );
while( m_pSearch->GetNextRow( hSearch) != S_ADS_NOMORE_ROWS )
{
    // Get the samAccountName
    hr = m_pSearch->GetColumn( hSearch, pszAttr[2], &col );
    if ( FAILED(hr) )
    {
        hr = m_pSearch->AbandonSearch( hSearch );
        hr = m_pSearch->CloseSearchHandle(hSearch);
        m_pSearch->Release();
        break;
    }
    if (col.dwADsType == ADSTYPE_CASE_IGNORE_STRING)
       printf("%S\n", col.pADsValues->CaseIgnoreString); 
   m_pSearch->FreeColumn( &col );
}
 
m_pSearch->CloseSearchHandle( hSearch );

要件

サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	iads.h
[DLL]	Activeds.dll;Adsldp.dll;Adsldpc.dll

関連項目

ADSI エラー コード

IDirectorySearch

IDirectorySearch::ExecuteSearch

IDirectorySearch::SetSearchPreference