Export (0) Print
Expand All

SendInsecureMessageToCustodiansFromApplication Method

HealthVault
Sends an insecure message originating from the application to custodians of the specified health record.

Namespace: Microsoft.Health
Assembly: Microsoft.Health (in Microsoft.Health.dll) Version: 2.1.0.0 (1.15.1003.9505)

public void SendInsecureMessageToCustodiansFromApplication(
	Guid recordId,
	bool addressMustBeValidated,
	string senderMailboxName,
	string senderDisplayName,
	string subject,
	string textBody,
	string htmlBody
)

Parameters

recordId
Type: System..::..Guid
The unique identifier of the health record for which the custodians should be sent the message.
addressMustBeValidated
Type: System..::..Boolean
If true, HealthVault will only send the message to custodians with validated e-mail addresses. If false, the message will be sent even if the custodians' addresses have 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.

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. The calling application and the person through which authorization to the specified record was obtained must be authorized for the record. The person must be either authenticated, or if the person is offline, their person Id specified as the offline person Id. See OfflineWebApplicationConnection for more information.

ExceptionCondition
System..::..ArgumentException If recordId is 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.
Show:
© 2014 Microsoft