Search Method

Description

Search for a specific message or set of messages.

Syntax

Visual Basic
Public Sub Search( _ ByVal Criteria As String, _ ByRef MsgSet As Variant, _ Optional ByVal CharacterSet As String _ )

Visual Basic

Public Sub Search( _
   ByVal Criteria As String, _
   ByRef MsgSet As Variant, _
   Optional ByVal CharacterSet As String _
)

Parameters

Criteria: Specifies the criteria used for searching. This string must be in the format specified by RFC 2060 Section 6.4.4.
MsgSet: Undimensioned string. Where the reply from the search will be put. Any contents will be replaced.
CharacterSet: Specifies the character set used for the search.

Remarks

MsgSet will be empty or will contain numbers separated by a space. These numbers specify the message numbers on the server that meet the search criteria. MsgSet must not go out of scope while the command completes (it must have file or global scope).

Error Codes

This method may generate the following error code (refer to MailErrorConstants for a complete list of error codes):

ptBlocked
ptConnectionAborted
ptConnectionReset
ptNetworkDown
ptNetworkReset
ptNoBufferSpace
ptNotConnected
ptProtocol
ptTimeout