IMAPIContainer::SetSearchCriteriaIMAPIContainer::SetSearchCriteria

適用されます: OutlookApplies to: Outlook

コンテナーの検索基準を確立します。Establishes search criteria for the container.

HRESULT SetSearchCriteria(
  LPSRestriction lpRestriction,
  LPENTRYLIST lpContainerList,
  ULONG ulSearchFlags
);

ParametersParameters

lpRestrictionlpRestriction

[in]検索条件を定義するSRestriction構造体へのポインター。[in] A pointer to an SRestriction structure that defines the search criteria. _LpRestriction_パラメーターに NULL を渡した場合、このコンテナーの最も最近使用した検索条件が再度使用されます。If NULL is passed in the lpRestriction parameter, the search criteria that were used most recently for this container are used again. NULL 渡すことはできません_lpRestriction_のコンテナー内の最初の検索をします。NULL should not be passed in lpRestriction for the first search in a container.

lpContainerListlpContainerList

[in]検索に含まれるコンテナーを表すエントリの識別子の配列へのポインター。[in] A pointer to an array of entry identifiers that represent containers to be included in the search. _LpContainerList_パラメーターに NULL を渡すと、クライアント、新しい検索のこのコンテナーを検索するのには最近使った項目識別子が使用されます。If a client passes NULL in the lpContainerList parameter, the entry identifiers used most recently to search this container are used for the new search. クライアントは、コンテナー内の最初の検索の_lpContainerList_に NULL を渡さないでください。A client should not pass NULL in lpContainerList for the first search in a container.

ulSearchFlagsulSearchFlags

[in]検索の実行方法を制御するフラグのビットマスクです。[in] A bitmask of flags that control how the search is performed. 次のフラグを設定することができます。The following flags can be set:

BACKGROUND_SEARCHBACKGROUND_SEARCH

検索は、他の検索基準にして通常の優先順位で実行する必要があります。The search should run at normal priority relative to other searches. FOREGROUND_SEARCH フラグと同時には、このフラグを設定することはできません。This flag cannot be set at the same time as the FOREGROUND_SEARCH flag.

FOREGROUND_SEARCHFOREGROUND_SEARCH

検索は、他の検索基準とした優先度の高いで実行する必要があります。The search should run at high priority relative to other searches. BACKGROUND_SEARCH フラグと同時には、このフラグを設定することはできません。This flag cannot be set at the same time as the BACKGROUND_SEARCH flag.

NON_CONTENT_INDEXED_SEARCHNON_CONTENT_INDEXED_SEARCH

検索使用しないでくださいコンテンツのインデックス作成に一致するエントリを検索します。The search should not use content indexing to find matching entries. このフラグで、Exchange ストアに対してのみです。This flag is only valid for Exchange stores.

RECURSIVE_SEARCHRECURSIVE_SEARCH

検索では、 _lpContainerList_パラメーターとそのすべての子コンテナーで指定されたコンテナーを含める必要があります。The search should include the containers specified in the lpContainerList parameter and all their child containers. SHALLOW_SEARCH フラグと同時には、このフラグを設定することはできません。This flag cannot be set at the same time as the SHALLOW_SEARCH flag.

RESTART_SEARCHRESTART_SEARCH

検索は、これは、 SetSearchCriteria、最初の呼び出しを開始または検索がアクティブでない場合に再起動する必要があります。The search should be initiated if this is the first call to SetSearchCriteria, or restarted if the search is inactive. STOP_SEARCH フラグと同時には、このフラグを設定することはできません。This flag cannot be set at the same time as the STOP_SEARCH flag.

SHALLOW_SEARCHSHALLOW_SEARCH

検索に一致するエントリの_lpContainerList_パラメーターで指定したコンテナーでのみです。The search should look only in the containers specified in the lpContainerList parameter for matching entries. RECURSIVE_SEARCH フラグと同時には、このフラグを設定することはできません。This flag cannot be set at the same time as the RECURSIVE_SEARCH flag.

STOP_SEARCHSTOP_SEARCH

検索を停止する必要があります。The search should be stopped. RESTART_SEARCH フラグと同時には、このフラグを設定することはできません。This flag cannot be set at the same time as the RESTART_SEARCH flag.

�߂�lReturn value

S_OKS_OK

検索条件が正しく設定されました。The search criteria was successfully set.

MAPI_E_TOO_COMPLEXMAPI_E_TOO_COMPLEX

サービス プロバイダーは、指定された検索条件をサポートしていません。The service provider does not support the specified search criteria.

RemarksRemarks

IMAPIContainer::SetSearchCriteriaメソッドは、通常の検索結果フォルダーの検索をサポートするコンテナーの検索基準を確立します。The IMAPIContainer::SetSearchCriteria method establishes search criteria for a container that supports searches, typically a search-results folder. 検索結果フォルダーには、検索条件に一致するメッセージへのリンクが含まれています。実際のメッセージは、元の場所に保存されています。A search-results folder contains links to the messages that meet the search criteria; the actual messages are still stored in their original locations. 検索結果のフォルダーに含まれているのみに固有のデータは、その内容のテーブルです。The only unique data that is contained in a search-results folder is its contents table. 検索結果フォルダーの内容のテーブルでは、検索の制限が適用された後にメッセージ ・ ストアがマージされた内容があります。The contents table of a search-results folder has the merged contents of the message store after the search restriction has been applied.

検索操作は、この内容が結合されたテーブルでのみ動作します。他の検索結果のフォルダーを検索しません。A search operation works only on this merged contents table; it does not search through other search-results folders. 検索結果が検索条件に一致するメッセージのみを返すフォルダー階層は返されません。The search results return only the messages that match the search criteria; the folder hierarchy is not returned.

検索が完了すると、制御がクライアントに返されます。Control is returned to the client when the search has finished.

実装者へのメモNotes to implementers

アドレス帳コンテナーは、その内容のテーブルに制限を適用することで検索条件を確立します。Address book containers establish search criteria by applying restrictions to their contents tables. 詳細については検索条件とアドレス帳コンテナー、高度な検索を実装するを参照してください。For more information about search criteria and address book containers, see Implementing Advanced Searching.

必要がありますオープンをサポートして、コピー、移動、および削除の各操作の検索結果のフォルダー内のメッセージに、検索結果フォルダー自体ではなく。You should support open, copy, move, and delete operations on the messages within search-results folders, not on the search-results folder itself. 内に作成または検索結果のフォルダーにコピーするメッセージを許可しません。Do not allow messages to be created within or copied into a search-results folder.

呼び出し側への注意Notes to callers

メッセージの受信者を検索するには、 PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients) に設定するSSubRestriction構造体のulSubObjectメンバーとサブオブジェクトの制限] をポイントする_lpRestriction_を設定します。To search for message recipients, set lpRestriction to point to a subobject restriction with the ulSubObject member in the SSubRestriction structure set to PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients). 添付ファイルを検索するには、 PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments) にulSubObjectのメンバーを設定します。To search for attachments, set the ulSubObject member to PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments). 受信者や添付ファイルの検索条件を記述するプロパティの制限] をポイントして、 lpResのメンバーを設定します。Set the lpRes member to point to a property restriction that describes the search criteria for the recipients or attachments.

たとえば、拡張子 .mss を含む添付ファイルを探すようにPR_MESSAGE_ATTACHMENTSPR_ATTACH_EXTENSION (PidTagAttachExtensionに一致するプロパティの制限をlpResulSubObjectを設定します。) を持つ。 mss。For example, to look for file attachments that have the extension .mss, set ulSubObject to PR_MESSAGE_ATTACHMENTS and lpRes to a property restriction that matches PR_ATTACH_EXTENSION (PidTagAttachExtension) with .mss.

_UlSearchFlags_パラメーターに FOREGROUND_SEARCH フラグを設定すると、システム パフォーマンスが低下可能性があります。Setting the FOREGROUND_SEARCH flag in the ulSearchFlags parameter could cause a decrease in system performance.

既に進行中の検索の検索条件を変更するのにはSetSearchCriteriaを使用することができます。You can use SetSearchCriteria to change the search criteria of a search already in progress. 新しい制限を検索するには、フォルダーと新しい検索の優先順位、優先度の高い検索にアップグレードするなどの新しいリストを指定できます。You can specify new restrictions, new lists of folders to search, and a new search priority, such as upgrading a search to a higher priority. 検索の優先順位の変更を再起動して、既存の検索が発生しないが、条件を検索するには、その他の変更ができます。Changes in search priority do not cause an existing search to restart, but other changes to search criteria can.

検索結果フォルダーを使用するが、フォルダーを削除するか、後で使用するために開いたままにできるようにします。When you are through using a search-results folder, you can either delete the folder or let it remain open for later use. 検索結果フォルダーを削除すると、メッセージのリンクのみが削除されます。If you do delete the search-results folder, only message links are deleted. 実際のメッセージは、その親フォルダーに残ります。The actual messages remain in their parent folders.

検索結果フォルダーの詳細については、 MAPI 検索フォルダーを参照してください。For more information about search-results folders, see MAPI Search Folders.

MFCMAPI 参照MFCMAPI reference

MFCMAPI �T���v�� �R�[�h�ł́A���̕\��Q�Ƃ��Ă��������BFor MFCMAPI sample code, see the following table.

�t�@�C��File �֐�Function �R�����gComment
HierarchyTableDlg.cppHierarchyTableDlg.cpp
CHierarchyTableDlg::OnEditSearchCriteriaCHierarchyTableDlg::OnEditSearchCriteria
MFCMAPI では、 IMAPIContainer::SetSearchCriteriaメソッドを使用して、ユーザーがそれを編集した後、フォルダーの検索条件を記述します。MFCMAPI uses the IMAPIContainer::SetSearchCriteria method to write search criteria for a folder after a user has edited it.

関連項目See also

IMAPIContainer::GetContentsTableIMAPIContainer::GetContentsTable

IMAPIContainer::OpenEntryIMAPIContainer::OpenEntry

IMAPIFolder::CreateFolderIMAPIFolder::CreateFolder

IMAPIFolder: IMAPIContainerIMAPIFolder : IMAPIContainer

SPropertyRestrictionSPropertyRestriction

SRestrictionSRestriction

SSubRestrictionSSubRestriction

IMAPIContainer: IMAPIPropIMAPIContainer : IMAPIProp

[�R��h �T���v���Ƃ��� MFCMAPIMFCMAPI as a Code Sample