GetProperties Method

PropertyAccessor.GetProperties Method (Outlook)

Office 2013 and later

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Obtains the values of the properties specified by the one-dimensional array SchemaNames.

expression .GetProperties(SchemaNames)

expression A variable that represents a PropertyAccessor object.




Data Type





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.

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.

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.

Sub DemoPropertyAccessorGetProperties() 
 Dim PropNames() As Variant 
 Dim myValues As Variant 
 Dim i As Integer 
 Dim j As Integer 
 Dim oMail As Object 
 Dim oPA As Outlook.PropertyAccessor 
 'Get first item in the inbox 
 Set oMail = _ 
 PropNames = _ 
 Array("", _ 
 "", _ 
 "", _ 
 'Obtain an instance of a PropertyAccessor object 
 Set oPA = oMail.PropertyAccessor 
 'Get myValues array with GetProperties call 
 myValues = oPA.GetProperties(PropNames) 
 For i = LBound(myValues) To UBound(myValues) 
 'Examine the type of the element 
 If IsError(myValues(i)) Then 
 'CVErr returns a variant of subtype error 
 Debug.Print (CVErr(myValues(i))) 
 ElseIf IsArray(myValues(i)) Then 
 propArray = myValues(i) 
 For j = LBound(propArray) To UBound(propArray) 
 Debug.Print (propArray(j)) 
 ElseIf IsNull(myValues(i)) Then 
 Debug.Print ("Null value") 
 ElseIf IsEmpty(myValues(i)) Then 
 Debug.Print ("Empty value") 
 ElseIf IsDate(myValues(i)) Then 
 Debug.Print (oPA.UTCToLocalTime(myValues(i))) 
 'VB does not have IsBinary function 
 ElseIf VarType(myValues(i)) = vbByte Then 
 Debug.Print (oPA.BinaryToString(myValues(i))) 
 Debug.Print (myValues(i)) 
 End If 
End Sub
© 2016 Microsoft