Location

Provides methods to get and set the location of a meeting in an Outlook add-in.

Requirements
Requirement Value
Minimum mailbox requirement set version 1.1
Minimum permission level ReadItem
Applicable Outlook mode Compose

Methods

getAsync([options], callback)

Gets the location of an appointment.

The getAsync method starts an asynchronous call to the Exchange server to get the location of an appointment.

Parameters:
Name Type Attributes Description
options Object <optional> An object literal that contains one or more of the following properties.

Properties
NameTypeAttributesDescription
asyncContextObject<optional>Developers can provide any object they wish to access in the callback method.
callback function When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.

The location of the appointment is provided as a string in the asyncResult.value property.|

Requirements
Requirement Value
Minimum mailbox requirement set version 1.1
Minimum permission level ReadItem
Applicable Outlook mode Compose

setAsync(location, [options], [callback])

Sets the location of an appointment.

The setAsync method starts an asynchronous call to the Exchange server to set the location of an appointment. Setting the location of an appointment overwrites the current location.

Parameters:
Name Type Attributes Description
location String The location of the appointment. The string is limited to 255 characters.
options Object <optional> An object literal that contains one or more of the following properties.

Properties
NameTypeAttributesDescription
asyncContextObject<optional>Developers can provide any object they wish to access in the callback method.
callback function <optional> When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
If setting the location fails, the asyncResult.error property will contain an error code.
Error codeDescription
DataExceedsMaximumSizeThe location parameter is longer than 255 characters.
Requirements
Requirement Value
Minimum mailbox requirement set version 1.1
Minimum permission level ReadItem
Applicable Outlook mode Compose