Dart Smtp, Pop, Imap Controls
Find Method
Specifies the symbolic name for the label to find. If msgNull, the LabelString parameter will be used as the search string.
Optional. Specifies the label to find. Use this parameter to find a non-standard label (not available in LabelConstants). When using this parameter, Label should be msgNull.
Optional. Indicates the index to start the search after. StartAfter is updated to reflect the index of the header field found.
Description
Find a header field in the collection.
Syntax
Visual Basic
Public Function Find( _
   ByVal Label As LabelConstants, _
   Optional ByVal LabelString As String, _
   Optional ByRef StartAfter As Long = 0 _
) As String
Parameters
Label
ValueDescription
msgAlsoControl"Also-Control:"
msgAlternateRecipient"Alternate-Recipient:"
msgApparentlyTo"Apparently-To:"
msgApproved"Approved:"
msgArticleNames"Article-Names:"
msgArticleUpdates"Article-Updates:"
msgAutoForwarded"Auto-Forwarded:"
msgComments"Comments:"
msgContentBase"Content-Base:"
msgContentConversion"Content-Conversion:"
msgContentDescription"Content-Description:"
msgContentDisposition"Content-Disposition:"
msgContentID"Content-ID:"
msgContentIdentifier"Content-Identifier:"
msgContentLanguage"Content-Language:"
msgContentLength"Content-Length:"
msgContentLocation"Content-Location:"
msgContentMD5"Content-MD5:"
msgContentReturn"Content-Return:"
msgContentSGMLEntity"Content-SGML-Entity:"
msgContentTransferEncoding"Content-Transfer-Encoding:"
msgContentType"Content-Type:"
msgControl"Control:"
msgConversion"Conversion:"
msgConversionWithLoss"Conversion-With-Loss:"
msgDate"Date:"
msgDeliveryDate"Delivery-Date:"
msgDeliveryReport"Delivery-Report:"
msgDiscardedX400IPMSExtensions"Discarded-X400-IPMS-Extensions:"
msgDiscardedX400MTSExtensions"Discarded-X400-MTS-Extensions:"
msgDiscloseRecipients"Disclose-Recipients:"
msgDistribution"Distribution:"
msgDLExpansionHistoryIndication"DL-Expansion-History-Indication:"
msgEncoding"Encoding:"
msgErrorsTo"Errors-To:"
msgExpires"Expires:"
msgFax"Fax:"
msgFcc"Fcc:"
msgFollowupTo"Followup-To:"
msgForComment"For-Comment:"
msgForHandling"For-Handling:"
msgFrom"From:"
msgGenerateDeliveryReport"Generate-Delivery-Report:"
msgImportance"Importance:"
msgIncompleteCopy"In-Reply-To:"
msgInReplyTo"Incomplete-Copy:"
msgKeywords"Keywords:"
msgLanguage"Language:"
msgLines"Lines:"
msgMailer"Mailer:"
msgMailSystemVersion"Mail-System-Version:"
msgMessageID"Message-ID"
msgMessageType"Message-Type:"
msgMIMEVersion"MIME-Version:"
msgNewsgroups"Newsgroups:"
msgNullN/A
msgObsoletes"Obsoletes:"
msgOrganisation"Organisation:"
msgOrganization"Organization:"
msgOriginalEncodedInformationTypes"Original-Encoded-Information-Types:"
msgOriginatingClient"Originating-Client:"
msgPath"Path:"
msgPhone"Phone:"
msgPrecedence"Precedence:"
msgPreventNonDeliveryReport"Prevent-NonDelivery-Report:"
msgPriority"Priority:"
msgReceived"Received:"
msgReferences"References:"
msgReplyBy"Reply-By:"
msgReplyTo"Reply-To:"
msgReturnPath"Return-Path:"
msgReturnReceiptTo"Return-Receipt-To:"
msgSeeAlso"See-Also:"
msgSender"Sender:"
msgSensitivity"Sensitivity:"
msgStatus"Status:"
msgSubject"Subject:"
msgSummary"Summary:"
msgSupersedes"Supersedes:"
msgTelefax"Telefax:"
msgX400ContentReturn"X400-Content-Return:"
msgXMailer"X-Mailer:"
msgXNewsreader"X-Newsreader:"
msgXref"Xref:"
Specifies the symbolic name for the label to find. If msgNull, the LabelString parameter will be used as the search string.
LabelString
Optional. Specifies the label to find. Use this parameter to find a non-standard label (not available in LabelConstants). When using this parameter, Label should be msgNull.
StartAfter
Optional. Indicates the index to start the search after. StartAfter is updated to reflect the index of the header field found.
Return Value
The requested header field.
Remarks

This method searches the collection for a label. On return, StartAfter is updated to reflect the index of the label found; this allows you to find multiple header fields that have the same label.

StartAfter cannot be a constant because the method updates its value. Providing a constant value for StartAfter generates a run-time error. Specifying StartAfter with a value of zero starts the search at the head of the collection. StartAfter is set to 0 and "" is returned if the item is not found.

Error Codes

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

Example

HeaderFields Collection

See Also

HeaderFields Collection  | HeaderFields Members


PowerTCP Mail for ActiveX Documentation Version 2.13
© 2018 Dart Communications. All Rights Reserved.
Send comments on this topic