OMret_obj_path

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>.".

Examples

/* 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));

See Also

none.