ApplicationConnection.SendInsecureMessageFromApplication Method (IList(Guid), Boolean, String, String, String, String, String) (Microsoft.Health)

Collapse AllExpand All Code: All Code: Multiple Code: Visual Basic Code: C#

SendInsecureMessageFromApplication Method (IList(Guid), Boolean, String, String, String, String, String)

Sends an insecure message originating from the application to the specified message recipients.

Namespace: Microsoft.Health
Assembly: Microsoft.Health (in Microsoft.Health.dll)

Syntax

Visual Basic (Declaration)

Public Sub SendInsecureMessageFromApplication ( _
    recipientPersonIds As IList(Of Guid), _
    addressMustBeValidated As Boolean, _
    senderMailboxName As String, _
    senderDisplayName As String, _
    subject As String, _
    textBody As String, _
    htmlBody As String _
)

Visual Basic (Usage)

Dim instance As ApplicationConnection
Dim recipientPersonIds As IList(Of Guid)
Dim addressMustBeValidated As Boolean
Dim senderMailboxName As String
Dim senderDisplayName As String
Dim subject As String
Dim textBody As String
Dim htmlBody As String

instance.SendInsecureMessageFromApplication(recipientPersonIds, _
    addressMustBeValidated, senderMailboxName, _
    senderDisplayName, subject, textBody, _
    htmlBody)

public void SendInsecureMessageFromApplication(
    IList<Guid> recipientPersonIds,
    bool addressMustBeValidated,
    string senderMailboxName,
    string senderDisplayName,
    string subject,
    string textBody,
    string htmlBody
)

Parameters

recipientPersonIds: Type: System.Collections.Generic..::.IList<(Of <(Guid>)>)
The unique identifiers of the people to which the message should be sent.

addressMustBeValidated: Type: System..::.Boolean
If true, HealthVault will ensure that the person has validated their message address before sending the mail. If false, the message will be sent even if the person's address has not been validated.

senderMailboxName: Type: System..::.String
An application specified mailbox name that's sending the message. The mailbox name is appended to the application's domain name to form the From email address of the message. This parameter should only contain the characters before the @ symbol of the email address.

senderDisplayName: Type: System..::.String
The message sender's display name.

subject: Type: System..::.String
The subject of the message.

textBody: Type: System..::.String
The text body of the message.

htmlBody: Type: System..::.String
The HTML body of the message.

Remarks

If both the textBody and htmlBody of the message is specified then a multi-part message will be sent so that the html body will be used and fallback to text if not supported by the client. If the domain name of the application has not been previously set (usually through app registration), this method will throw a HealthServiceException.

Exceptions

Exception	Condition
System..::.ArgumentException	If personIds is null or empty, -or- if senderMailboxName is null or empty, -or- if senderDisplayName is null or empty, -or- if subject is null or empty, -or- if textBody and htmlBody are both null or empty.
Microsoft.Health..::.HealthServiceException	If the server returned a failure when making the request.