SdsPutExtra - Write to the extra information field of an object.

Function

Write to the extra information field of an object.

Description

Write a specified number of bytes to the extra information field of an object. A maximum of 128 bytes may be written to an internal object. It is permissible to write to the extra information field of an external object, but the number of bytes written must not exceed the number originally in the object.

Language

C

Declaration

void SdsPutExtra(SdsIdType id, long nextra, char* extra, StatusType * SDSCONST status)

Parameters

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

>idSdsIdTypeIdentifier of the object
>nextralongNumber of bytes of extra information.
>extrachar*The extra information to be included. nextra bytes are copied into the object.
!statusStatusType*Modified status. Possible failure codes are:

SDS__BADID The identifier is invalid.
SDS__EXTRA Too much extra data.

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