pbms_get_metadata_value
Description
pbms_bool pbms_get_metadata_value ( PBMS pbms, const char * name, char * value, size_t * size )
Gets the value for metadata field name from the connection. If there is more than one field with the same name then which value is returned by this function is undefined.

If no matching header is found then FALSE is returned and no error number is set.

A list of standard metadata headers returned with all BLOBs can be found here.

Parameters
pbms
A valid PBMS connection handle.
name
The name of he metadata.
value
A buffer for the metadata value.
size
A pointer to a variable containing the size of the 'value' buffer. On return this variable will contain the actual size required for the value. If in doubt the caller should check this variable after the call to see if the value was truncated. If NULL is passed in then the buffer is assumed to be large enough to hold the metadata value.
Return Values

Returns TRUE on success.

Returns FALSE on failure. Use pbms_errno() and pbms_error() to retrieve error details.

If FALSE is returned but there is no error then the metadata header could not be found.

Example
Seee the example for pbms_add_metadata().
		
Related functions
pbms_reset_metadata() pbms_next_metadata()