priority and the secondary being a serial number.
globus_priority_q_cmp_func_t and pass that to globus_priority_q_init().
To remove a datum ignoring its priority, use globus_priority_q_remove().
To modify the priority of a datum already in the queue, use globus_priority_q_modify().
> 0 The priority of priority_1 is less than that of priority_2.
< 0 The priority of priority_1 is greater than that of priority_2.
= 0 The priorities of priority_1 and priority_2 are the same.
priority_q Pointer to the priority queue structure to initialize.
or free them before calling this function.
priority_q Pointer to the priority_q to destroy.
returns GLOBUS_TRUE; otherwise it returns GLOBUS_FALSE.
special value GLOBUS_FAILURE is returned if a null pointer is passed to this function.
pointer is NULL or the priority queue is empty, this function returns NULL.
priority_q Pointer to the priority queue to remove from.
This function returns the highest-priority datum from the priority queue.
This function returns the highest priority value in the priority queue.
datum Pointer to the datum to search for.
datum is not present, this function returns NULL.
This function returns the old priority of datum.