This function is called if ChooseMultipleRecords returns a value greater than zero. It fills the recordIDs array with the record identifiers of the selected records in the order in which they are to appear within HotDocs. The records associated with these identifiers are assumed to be in an open state ready for read-only access.
This function was introduced with the release of HotDocs 2005 SP2. Earlier versions of HotDocs will not call this function.
long GetChosenRecords ( long* recordIDs )
| Parameters | Description |
| recordIDs | An array of long values allocated and passed in by the caller (HotDocs) guaranteed to be sizeof(long)*NumSelRecs where NumSelRecs is the value returned by the previous call to ChooseMultipleRecords.
HotDocs assumes that all record IDs returned by an answer source are greater than or equal to zero. That is, negative record IDs are not allowed. |
Return HD_SUCCESS (1) if successful, and HD_FAILURE (0) if otherwise.