PropertyAccessor.GetProperties Method
Outlook Developer Reference |
Obtains the values of the properties specified by the one-dimensional array
SchemaNames
.
Version Information
Version Added: Outlook 2007
Syntax
expression.GetProperties(SchemaNames)
expression A variable that represents a PropertyAccessor object.
Parameters
Name | Required/Optional | Data Type | Description |
---|---|---|---|
SchemaNames | Required | Variant | An array that contains the names of the properties whose values are to be returned. These properties are referenced by namespace. For more information, see Referencing Properties by Namespace. |
Return Value
A Variant that represents an array of values of the properties specified in the parameter
SchemaNames
. The number of elements in the returned array equals the number of elements in the
SchemaNames
array. If an error occurs for getting a specific property, the Err value will be returned in the corresponding location in the returned array.
Remarks
The array returned by GetProperties can contain elements of different types, depending on the type of the property requested. The type of the array element returned by GetProperties will be the same as the type of the underlying property. Certain raw property types such as PT_OBJECT are unsupported and will raise an error. If you require conversion of the raw property type, for example, from PT_BINARY to a string, or from PT_SYSTIME to a local time, use the helper methods PropertyAccessor.BinaryToString and PropertyAccessor.UTCToLocalTime.
For more information on getting properties using the PropertyAccessor object, see Best Practices for Getting and Setting Properties.
Example
The following code sample shows how to use the PropertyAccessor object to get MAPI properties that are not exposed on an Outlook item, namely: PR_SUBJECT, PR_ATTR_HIDDEN, PR_ATTR_READONLY, and PR_ATTR_SYSTEM. This code sample uses the GetProperties method to retrieve them in a single call, specifying an array of namespace references to these properties, and obtains a returned array that contains the raw value for each property.
Visual Basic for Applications |
---|
|
See Also