Search.Save Method

Outlook Developer Reference

Saves the search results to a Search Folder.

Syntax

expression.SaveSchFldrName

expression   A variable that represents a Search object.

Parameters

Name Required/Optional Data Type Description
SchFldrName Required String A string that represents the Search Folder name.

Remarks

The Save method displays an error if a Search Folder with the same name already exists.

Example

The following Microsoft Visual Basic for Applications (VBA) example searches the Inbox for items with Subject line equal to 'Test' and saves the results in a Search Folder. The AdvanceSearchComplete event procedure sets the Boolean blnSearchComp to True when the the search is complete. This Boolean variable is used by the TestAdvancedSearchComplete() procedure to determine when the search is complete. The sample code must be placed in a class module such as ThisOutlookSession, and the TestAdvancedSearchComplete() procedure must be called before the event procedure can be called by Outlook.

Visual Basic for Applications
  Public blnSearchComp As Boolean

Private Sub Application_AdvancedSearchComplete(ByVal SearchObject As Search) MsgBox "The AdvancedSearchComplete Event fired" blnSearchComp = True End Sub

Sub TestAdvancedSearchComplete() Dim sch As Outlook.Search Dim rsts As Outlook.Results Dim i As Integer blnSearchComp = False Const strF As String = "urn:schemas:mailheader:subject = 'Test'" Const strS As String = "Inbox"
Set sch = Application.AdvancedSearch(strS, strF) While blnSearchComp = False DoEvents Wend sch.Save("Subject Test") End Sub

See Also