This is an inbuilt function function provided by PPWIZARD.
This function is useful if you wish to ensure that when GetId() is called a specific value for an ID is used. An example of where this might be useful is if you have external entry points into a set of generated html pages. You normally would not care what they are called as long as all the links work, however as soon as you wish externally generated html to link to specific pages you must do something to ensure that the links name does not change.
The function takes 3 parameters as follows:
There is one situation where you may wish to pass a empty key ('') and that is when you specified unique ID mode on GetIdPrepare(). You would do this to pass an ID that you never want returned by GetId().
#evaluate '' ^call GetIdPrepare 'PPW'^ #evaluate '' ^call SetId 'PPW', '#define', "HashDef"^ ;;Set preferred ID #evaluate '' ^say GetId('PPW', 'MAXCHARS', 'define')^ #evaluate '' ^say GetId('PPW', 'MAXCHARS', '#define')^