Queries the priority property of a calendar component object.
Return value for the priority property. This should be freed using the free_priority function.