insightattachstatus

Purpose

Indicates the status of the most recent attempt to access or modify an attachment.

Synopsis

function insightattachstatus:integer

Return value

One of the following constants:

INSIGHT_ATTACH_OK: The operation completed successfully.
INSIGHT_ATTACH_RUNTIME_ERROR: An internal error occurred
INSIGHT_ATTACH_NOT_FOUND: The specified attachment does not exist.
INSIGHT_ATTACH_SEVERAL_FOUND: Several attachments match the given tag but the procedure only allows for one to be retrieved.
INSIGHT_ATTACH_INVALID_FILENAME: An attachment could not be created or renamed because the specified filename is invalid. It may be too long, too short, or contain invalid characters.
INSIGHT_ATTACH_INVALID_DESCRIPTION: The specified description is invalid. The description can be a maximum of 2500 characters in length.
INSIGHT_ATTACH_ALREADY_EXISTS: An attachment could not be created because another attachment with the same name already exists.
INSIGHT_ATTACH_TOO_LARGE: An attachment could not be created because another attachment with the same name already exists. Attachments can be a maximum of 60Mb in size.
INSIGHT_ATTACH_TOO_MANY: An attachment could not be created because the maximum number of attachments (100) has been reached for the project or scenario.

Further information

After every call to an attachment-related function or procedure, you should check the value of insightattachstatus to see if your request succeeded.