STD.File.RemoveOwnedSubFiles( superfile [ , delete ])
| superfile | A null-terminated string containing the logical name of the superfile. |
| delete | A boolean flag specifying to delete the sub-files from disk when TRUE or just remove them from the superfile list of files. If omitted, the default is to just remove them from the superfile list of files. |
| Return: | Null. |
The RemoveOwnedSubFiles function removes all owned sub-files from the specified superfile. These are only removed if they are soley owned by the superfile. If a subfile is co-owned, (i.e.,a member of any other superfile), then the removal is ignored.
This function may be included in a superfile transaction, unless the delete Flag is TRUE.
Example:
SEQUENTIAL(
STD.File.StartSuperFileTransaction(),
STD.File.RemoveOwnedSubFiles('MySuperFile'),
STD.File.FinishSuperFileTransaction()
);