|
Purpose
|
Returns a reference number that is unique for the specified file that will correspond to the specified tag. Creates a new tag/reference number pair. |
|
Return value
|
Returns the reference number if successful and 0 otherwise. |
|
Description
|
Successive calls to Hnewref will generate a increasing sequence of reference number values until the highest possible reference number value has been returned. It will then return unused reference number values starting from 1 in increasing order. |