SdsImport - Import an object from an external buffer

Function

Import an object from an external buffer

Description

Import an object from an external buffer and return an identifier to the internal copy created. The object must have been previously exported using SdsExport.

The original external version of the structure continues to exist, in addition to the internal copy.

A fully dynamic internal structure is created in which all SDS operations are valid. However, to merely access the data in an object SdsAccess can be used in place of SdsImport.

Language

C

Declaration

void SdsImport(void *data, SdsIdType *id, StatusType * SDSCONST status)

Parameters

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

>datavoid*The buffer from which the object will be imported.
<idSdsIdType*Identifier of the new internal object.
!statusStatusType*Modified status. Possible failure codes are:

SDS__NOTSDS Not a valid sds object.
SDS__NOMEM Insufficient memory.

Support

Jeremy Bailey, {AAO}

Version date

18-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