(v13) The RDR system

This page applies to Harlequin v13.1r0 and later; both Harlequin Core and Harlequin MultiRIP

The RDR system is a core API for entity publishing and discovery built on these concepts:

Registration
Classification
Prioritization
Iteration

It is defined by rdrapi.h and provides the following calls in API version 20110201(before Harlequin 13):

SwRegisterRDR
SwRegisterRDRandID
SwDeregisterRDR
SwFindRDR
SwFindRDRbyType
SwNextRDR
SwLockNextRDR
SwRestartFindRDR
SwFoundRDR

These additional calls are available in API version 20191120 (introduced in Harlequin 13):

SwRegisterNamedRDR
SwRegisterNamedRDRandID
SwDeregisterNamedRDR
SwFindNamedRDR
SwFindNamedRDRbyName

There were two additional calls in API version 20110201, but as of Harlequin 13 they are obsolete and will fail, returning NULL:

SwFindRDRs
SwFindRDRbyClass

RDR originally stood for ROM Data Resource, but since RDRs do not have to be in ROM nor contain any data that definition is now obsolescent, and entities registered with the RDR system are simply referred to as RDRs.