SdsGetExtra - Read from the extra information field of an object.

Function

Read from the extra information field of an object.

Description

Read bytes from the extra information field of an object. Bytes are copied until the supplied buffer is filled up or until all bytes in the field are copied.

Language

C

Declaration

void SdsGetExtra(SdsIdType id, long length, char* extra, unsigned long* actlen, StatusType * SDSCONST status)

Parameters

(">" input, "!" modified, "W" workspace, "<" output)

>idSdsIdTypeIdentifier of the object
>lengthlongLength of buffer to receive data.
<extrachar*Buffer to receive the extra information copied from the object.
<actlenunsigned long*actual number of bytes copied.
!statusStatusType*Modified status. Possible failure codes are:

SDS__BADID The identifier is invalid.

Support

Jeremy Bailey, {AAO}

Version date

24-Oct-91

Click here for the DRAMA home page and here for the AAO home page.

 For more information, contact tony.farrell@mq.edu.au