共用方式為


MAPI 搜尋資料夾

適用於:Outlook 2013 |Outlook 2016

search-results 資料夾會保留一般資料夾中訊息的連結,而不是實際訊息的連結。 用戶端會藉由呼叫 IMAPIFolder::CreateFolder 方法,並以 FOLDER_SEARCH 作為 ulFolderType 參數來建立 search-results 資料夾。 用戶端會藉由設定和套用搜尋準則來填入搜尋結果資料夾,這些規則會篩選出具有特定特性的訊息。 搜尋準則則是使用 IMAPIContainer::SetSearchCriteria 方法來設定。 用戶端會建置一或多個 SRestriction 結構,以代表要套用的搜尋準則,並將其傳遞至 SetSearchCriteriaSetSearchCriteria 也會指定資料夾清單,指出搜尋網域,以及控制搜尋執行方式的一組旗標。

SetSearchCriteria 會識別符合指定限制的訊息。 選取的訊息 (符合準則的訊息) 會顯示為 search-results 資料夾中的連結。 當用戶端呼叫 IMAPIContainer::GetContentsTable 方法來存取 search-results 資料夾的內容資料表時,選取的訊息會顯示在數據表中。 搜尋結果資料夾的內容資料表包含與一般資料夾的內容資料表相同的數據行。 不過,針對 search-results 資料夾, PR_PARENT_ENTRYID (PidTagParentEntryId) 屬性會指定連結訊息所在資料夾的專案識別碼。 搜尋結果資料夾不被視為父資料夾。

Search-results 資料夾具有下列限制:

  • 唯一可以修改 search-results 資料夾內容的方式是透過呼叫 SetSearchCriteria。 如需 SetSearchCriteria 實作的詳細資訊,請參閱知識庫文章 260322:如何使用 SetSearchCriteria 方法搜尋資料夾

  • 無法將訊息移動或複製到搜尋結果資料夾。

  • Search-results 資料夾不能包含子資料夾。

  • 客戶端無法將 search-results 資料夾設為搜尋的主旨。

不過,您可以修改 search-results 資料夾的屬性,並使用它來刪除訊息。 從 search-results 資料夾中刪除訊息時,實際上會從實際資料夾中刪除。 不過,刪除 search-results 資料夾本身不會影響內部的訊息;它們會保留在其一般資料夾中。

另請參閱

MAPI 資料夾