Synopsis
char *OMret_obj_path (
OMobj_id object_id,
char *object_name_buffer,
int buffer_size );
Description
OMret_obj_path returns the full pathname of an object.
Arguments
object_id
The object id.
object_name_buffer
The address of a character buffer in which to store the pathname. If you pass a NULL buffer, OMret_obj_path ignores the buffer_size argument and returns a malloced string. You should free the string when you're done with it by using free().
buffer_size
The size of the buffer, in bytes. OMret_obj_path returns at maximum this many bytes.
Returned value
On success, the address of object_name_buffer .
On failure, OMret_obj_path returns the string "<invalid>" or "<null>.".
Example
/* Print val1_id's full pathname. */
OMobj_id val1_id;
char val1_name[100];
int bufsize = 100;
...
printf("%s\n", OMret_obj_path (val1_id, val1_name, bufsize));