acedSSFree

C++

int acedSSFree(
    const ads_name sname
);

File

acedads.h

Description

Frees the specified selection set . The set must have been previously obtained from a call to acedSSGet() or acedSSAdd().

An ARX application cannot have more than 128 selection sets open at once. (The limit may be different on your system.) If the limit is reached, AutoCAD refuses to create more selection sets. Simultaneously managing a large number of selection sets is not recommended. Instead, keep a reasonable number of sets open at any given time, and call acedSSFree() to free unused selection sets as soon as possible. Unlike AutoLISP, the ARX environment has no automatic garbage collection to free selection sets after they have been used. An application should always free its open selection sets when it receives an kUnloadDwgMsg, kEndMsg, or kQuitMsg message.

If it succeeds, acedSSFree() returns RTNORM; otherwise, it returns an error code. When acedSSFree() fails, it sets the system variable ERRNO to a value that indicates the reason for the failure.

Parameters