Retrieves the content and the name of the specified AddOnObject from the project database.
GSErrCode ACAPI_AddOnObject_GetObjectContent ( const API_Guid& objectGuid, GS::UniString* objectName, GSHandle* objectContent );
Parameters
- objectGuid
- [in] The GUID of the object.
- objectName
- [out] The name of the specified object.
- objectContent
- [out] The content of the specified object.
Return Values
NoError
- The function has completed with success.
APIERR_BADPARS
- The passed parameter
objectGuid
isAPINULLGuid
or eitherobjectName
orobjectContent
isnullptr
. APIERR_BADID
- No object with the specified GUID exists.
For other common API errors see the API Errors document.
Remarks
Archicad allocates the target buffer in content
parameter; the caller add-on is responsible to dispose it with BMKillHandle
.
Requirements
- Version: API 19 or later
- Header: ACAPinc.h