Flesh out storage properties dimensions init and destroy

[aliddell]

• Document expected behavior for storage_properties_dimensions_s::init
• Change the return type of storage_properties_dimensions_s::init to int.
• Change the return type of storage_properties_dimensions_destroy() to void.
• Provide an official implementation for both init and destroy functions, set (and called) when calling storage_properties_init().
• Add a parameter to storage_properties_init() specifying the number of acquisition dimensions.
• Put an #ifndef guard around the definition of max in acquire.c to suppress compiler warnings.
• Call storage_properties_destroy() for every storage_properties_init() in the tests.