# ReleaseAttachment

Releases an attachment.

### Synopsis

`Err ReleaseAttachment (Item Attachment, TagArg *tagList)
Err ReleaseAttachmentVA (Item Attachment, uint32 tag1, ...)`

### Description

This function releases an attachment and is commonly used to release attachments started with `StartAttachment()`. `ReleaseAttachment()` causes an attachment in a sustain loop to enter release phase. Has no effect on attachment with no sustain loop, or not in its sustain loop.

### Arguments

Attachment
  The item number for the attachment.

### Tags

None

### Return Value

The function returns a non-negative value if successful or an error code (a negative value) if an error occurs.

### Implementation

SWI implemented in Audio folio V20.

### Caveats

Prior to V24, `ReleaseAttachment()` did not support envelope attachments.

### Associated Files

audio.h

### See Also

`StartAttachment``(),` StopAttachment`(),` LinkAttachments`()`