pbms_next_metadata
Description
pbms_bool pbms_next_metadata ( PBMS pbms, char * name, char * value, size_t * size )
Fetches the next name/value pair from the metadata cursor while advancing the cursor to the next row.

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

Parameters
pbms
A valid PBMS connection handle.
name
A buffer for the name of the metadata. This must have a size of atleast PBMS_META_NAME_SIZE bytes.
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 end of the cursor has been reached.

Example
pbms = pbms_connect("localhost", 8080, "aDatabase");

// Get a BLOB
pbms_get_data(pbms, a_blob_ref, blob_buffer, blob_size));

//-----------
// Dump the BLOB metadata
unsigned int cnt;
char buffer[80];
char name[PBMS_META_NAME_SIZE];

printf("BLOB metadata:\n");
cnt = pbms_reset_metadata(pbms); 
while (cnt) {
	size = 80;
	pbms_next_metadata(pbms, name, buffer, &size);
	printf("%s: %s\n", name, buffer);
	cnt--;
}

pbms_close(pbms);
		
Related functions
pbms_reset_metadata() pbms_get_metadata_value()